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

​
Thân yêu cầu

​
model
string
bắt buộc
ID của mô hình để sử dụng. Xem Models để biết các tùy chọn có sẵn.
​
messages
array
bắt buộc
Danh sách các tin nhắn tạo thành cuộc trò chuyện.Mỗi đối tượng tin nhắn chứa:
  • role (string): system, user, hoặc assistant
  • content (string | array): Nội dung tin nhắn
Khi content là một mảng, LemonData hỗ trợ các khối đa phương tiện có cấu trúc cho các mô hình tương thích:
  • text: { "type": "text", "text": "..." }
  • image: { "type": "image_url", "image_url": { "url": "https://..." } }
  • video: { "type": "video_url", "video_url": { "url": "https://..." } }
  • audio: { "type": "audio_url", "audio_url": { "url": "https://..." } }
Đối với lưu lượng sản xuất đa phương tiện, ưu tiên các URL công khai https. LemonData sẽ chuyển đổi các khối media này thành dạng yêu cầu cụ thể của nhà cung cấp cần thiết cho mô hình vật lý được chuyển hướng.
​
temperature
number
mặc định:"1"
Tham số nhiệt độ sampling trong khoảng 0 đến 2. Giá trị cao hơn làm đầu ra ngẫu nhiên hơn.
​
max_tokens
integer
Số token tối đa được sinh.
​
stream
boolean
mặc định:"false"
Nếu true, các delta tin nhắn từng phần sẽ được gửi dưới dạng sự kiện SSE.
​
stream_options
object
Các tùy chọn cho streaming. Đặt include_usage: true để nhận thông tin sử dụng token trong các đoạn stream.
​
top_p
number
mặc định:"1"
Tham số Nucleus sampling. Chúng tôi khuyến nghị điều chỉnh tham số này hoặc temperature, không cả hai.
​
frequency_penalty
number
mặc định:"0"
Số trong khoảng -2.0 đến 2.0. Giá trị dương phạt các token lặp lại.
​
presence_penalty
number
mặc định:"0"
Số trong khoảng -2.0 đến 2.0. Giá trị dương phạt các token đã xuất hiện trong văn bản.
​
stop
string | array
Tối đa 4 chuỗi mà tại đó API sẽ ngừng sinh token.
​
tools
array
Danh sách các công cụ mà mô hình có thể gọi (gọi hàm).
​
tool_choice
string | object
Điều khiển cách mô hình sử dụng công cụ. Tùy chọn: auto, none, required, hoặc một đối tượng công cụ cụ thể.
​
parallel_tool_calls
boolean
mặc định:"true"
Có bật gọi hàm song song hay không. Đặt thành false để gọi hàm tuần tự.
​
max_completion_tokens
integer
Số token tối đa cho phần completion. Thay thế cho max_tokens, hữu ích cho các họ mô hình mới hỗ trợ reasoning.
​
reasoning_effort
string
Mức độ nỗ lực suy luận cho các mô hình hỗ trợ reasoning. Tùy chọn: low, medium, high.
​
seed
integer
Giá trị seed ngẫu nhiên cho sampling mang tính xác định.
​
n
integer
mặc định:"1"
Số completions cần sinh (1-128).
​
logprobs
boolean
Có trả về log probabilities hay không.
​
top_logprobs
integer
Số log probabilities hàng đầu cần trả về (0-20). Yêu cầu logprobs: true.
​
top_k
integer
Tham số Top-K sampling (dành cho mô hình Anthropic/Gemini).
​
response_format
object
Đặc tả định dạng phản hồi. Sử dụng {"type": "json_object"} cho chế độ JSON. Xem {"type": "json_schema", "json_schema": {...}} như một cách tiếp cận cố gắng tốt nhất phụ thuộc vào mô hình được chọn và hành vi chuyển hướng.
​
logit_bias
object
Thay đổi khả năng xuất hiện của các token được chỉ định. Map token IDs (dưới dạng chuỗi) tới giá trị bias từ -100 đến 100.
​
user
string
Một định danh duy nhất đại diện cho người dùng cuối của bạn để giám sát lạm dụng.
​
cache_control
object
Tùy chọn điều khiển cache của LemonData.
  • type (string): Chiến lược cache - default, no_cache, no_store, response_only, semantic_only
  • max_age (integer): TTL cache tính bằng giây (tối đa 86400)

​
Phản hồi

​
id
string
Định danh duy nhất cho kết quả hoàn thiện.
​
object
string
Luôn là chat.completion.
​
created
integer
Unix timestamp khi kết quả hoàn thiện được tạo.
​
model
string
Mô hình được sử dụng cho completion.
​
choices
array
Danh sách các lựa chọn completion.Mỗi lựa chọn chứa:
  • index (integer): Chỉ số của lựa chọn
  • message (object): Tin nhắn được sinh ra
  • finish_reason (string): Lý do mô hình dừng (stop, length, tool_calls)
​
usage
object
Thống kê sử dụng token.
  • prompt_tokens (integer): Số token trong prompt
  • completion_tokens (integer): Số token trong completion
  • total_tokens (integer): Tổng số token đã sử dụng
curl -X POST "https://api.lemondata.cc/v1/chat/completions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "temperature": 0.7,
    "max_tokens": 1000
  }'

​
Ví dụ đa phương tiện

{
  "model": "gemini-2.5-pro",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Describe this video briefly." },
        { "type": "video_url", "video_url": { "url": "https://example.com/demo.mp4" } }
      ]
    }
  ],
  "max_tokens": 64
}

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1706000000,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 9,
    "total_tokens": 29
  }
}