Langsung ke konten utama

​
Overview

LemonData bekerja dengan SDK resmi OpenAI dengan mengarahkan klien ke https://api.lemondata.cc/v1. Untuk sebagian besar proyek baru, lebih baik menggunakan Chat Completions sebagai jalur default yang kompatibel dengan OpenAI. Gunakan Responses API hanya ketika Anda secara eksplisit membutuhkan perilaku khusus Responses. Field khusus Responses tidak dijamin berperilaku identik di setiap model dan jalur yang dirutekan.
Python, JavaScript, dan Go memiliki SDK resmi OpenAI. PHP bekerja dengan baik dengan klien komunitas yang kompatibel dengan OpenAI, namun itu bukan SDK resmi OpenAI.
Tipe: Native SDKJalur Utama: OpenAI-compatible / Chat CompletionsTingkat Dukungan: Jalur inti didukung

​
Installation

pip install openai
Gunakan POST /v1/responses hanya ketika Anda secara eksplisit membutuhkan perilaku khusus Responses. Beberapa field yang hanya untuk Responses masih dapat bergantung pada model yang dipilih dan jalur yang dirutekan.

​
Configure the Client

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-lemondata-key",
    base_url="https://api.lemondata.cc/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Explain what LemonData does in one sentence."}]
)

print(response.choices[0].message.content)

​
Advanced: Responses API

Gunakan jalur ini hanya ketika alat atau alur kerja Anda secara eksplisit bergantung pada semantik OpenAI Responses.

​
Streaming with Responses

stream = client.responses.create(
    model="gpt-5.4",
    input="Write a short poem about coding.",
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="")

​
Tools / Function Calling

response = client.responses.create(
    model="gpt-5.4",
    input="What's the weather in Tokyo?",
    tools=[{
        "type": "function",
        "name": "get_weather",
        "description": "Get weather for a location",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {"type": "string"}
            },
            "required": ["location"]
        }
    }]
)

for item in response.output:
    if item.type == "function_call":
        print(item.name)
        print(item.arguments)

​
Vision with Responses

response = client.responses.create(
    model="gpt-4o",
    input=[{
        "role": "user",
        "content": [
            {"type": "input_text", "text": "What's in this image?"},
            {"type": "input_image", "image_url": "https://example.com/image.jpg"}
        ]
    }]
)

print(response.output_text)

​
Embeddings

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="Hello world"
)

print(response.data[0].embedding[:5])

​
Chat Completions

Chat Completions adalah jalur default yang kompatibel dengan OpenAI untuk LemonData: 
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

​
Troubleshooting

  • Pastikan base URL persis https://api.lemondata.cc/v1
  • Periksa gangguan proxy atau penggantian klien HTTP kustom
  • Pastikan versi SDK Anda terbaru sebelum men-debug perilaku provider
  • Periksa bahwa API key Anda diawali dengan sk-
  • Verifikasi bahwa kunci aktif di dashboard LemonData
  • Konfirmasi SDK mengirim Authorization: Bearer ...
  • responses.create(...) mengirim permintaan ke /v1/responses
  • chat.completions.create(...) mengirim permintaan ke /v1/chat/completions
  • Gunakan Chat Completions secara default kecuali Anda secara eksplisit membutuhkan perilaku khusus Responses