Chuyển đến nội dung chính

​
Overview

LemonData hoạt động với các OpenAI SDK chính thức bằng cách trỏ client tới https://api.lemondata.cc/v1. Đối với hầu hết các dự án mới, ưu tiên Chat Completions làm đường dẫn tương thích OpenAI mặc định. Chỉ sử dụng Responses API khi bạn thực sự cần hành vi đặc thù của Responses. Các trường riêng cho Responses không được đảm bảo sẽ hoạt động giống hệt trên mọi mô hình và đường dẫn được định tuyến.
Python, JavaScript và Go có các OpenAI SDK chính thức. PHP hoạt động tốt với các client cộng đồng tương thích OpenAI, nhưng nó không phải là một OpenAI SDK chính thức.
Loại: SDK gốcĐường dẫn chính: Tương thích OpenAI / Chat CompletionsĐộ tin cậy hỗ trợ: Đường dẫn lõi được hỗ trợ

​
Installation

pip install openai
Sử dụng POST /v1/responses chỉ khi bạn thực sự cần hành vi đặc thù của Responses. Một số trường chỉ dành cho Responses vẫn có thể phụ thuộc vào mô hình được chọn và đường dẫn được định tuyến.

​
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

Sử dụng đường dẫn này chỉ khi công cụ hoặc quy trình làm việc của bạn phụ thuộc rõ ràng vào ngữ nghĩa của 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 là đường dẫn tương thích OpenAI mặc định cho 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

  • Xác minh rằng base URL chính xác là https://api.lemondata.cc/v1
  • Kiểm tra xem có proxy can thiệp hoặc các ghi đè client HTTP tùy chỉnh hay không
  • Đảm bảo phiên bản SDK của bạn là mới nhất trước khi gỡ lỗi hành vi của nhà cung cấp
  • Kiểm tra rằng khóa API của bạn bắt đầu với sk-
  • Xác minh rằng khóa đang hoạt động trên bảng điều khiển LemonData
  • Xác nhận SDK đang gửi Authorization: Bearer ...
  • responses.create(...) gửi yêu cầu tới /v1/responses
  • chat.completions.create(...) gửi yêu cầu tới /v1/chat/completions
  • Sử dụng Chat Completions theo mặc định trừ khi bạn thực sự cần hành vi riêng của Responses