跳轉到主要內容

​
概覽

LemonData API 是 相容於 OpenAI 的，這表示您只需更改 base URL 就能使用官方的 OpenAI SDK。對於大多數整合，從 POST /v1/chat/completions 開始。我們也支援原生 Anthropic 與 Gemini 請求格式，另外提供 POST /v1/responses 作為進階可選路徑。

​
基本 URL

https://api.lemondata.cc

​
驗證

所有 API 端點都需要使用 Bearer token 進行驗證： 
Authorization: Bearer sk-your-api-key
在 控制台 取得您的 API key。
關於互動 Playground：此文件網站上的 playground 僅供示範用途，且不支援輸入 API key。要測試 API，請使用：
  • cURL - 複製範例指令並將 sk-your-api-key 替換為您的實際金鑰
  • Postman - 匯入我們的 OpenAPI 規格
  • SDK - 使用 OpenAI/Anthropic SDK 並搭配我們的 base URL

​
支援的端點

​
聊天與文本生成

EndpointMethodDescription
/v1/chat/completionsPOST相容於 OpenAI 的聊天補完
/v1/messagesPOST相容於 Anthropic 的 messages API
/v1/responsesPOSTOpenAI Responses API

​
Embeddings 與 Rerank

EndpointMethodDescription
/v1/embeddingsPOST建立文字 embeddings
/v1/rerankPOST對文件進行重新排序

​
影像

EndpointMethodDescription
/v1/images/generationsPOST從文字生成影像
/v1/images/editsPOST編輯影像
/v1/images/generations/{id}GET針對以任務為基礎的影像回應的影像任務狀態路徑
部分影像模型可能會直接回傳內嵌結果，部分則會回傳以任務為基礎的回應，且有些會依據路由到的提供者而採取任一行為。如果建立回應包含 poll_url，請按該 URL 完整追蹤。

​
音訊

EndpointMethodDescription
/v1/audio/speechPOST文字轉語音 (TTS)
/v1/audio/transcriptionsPOST語音轉文字 (STT)

​
影片

EndpointMethodDescription
/v1/videos/generationsPOST建立影片生成任務
/v1/tasks/{id}GET取得影片工作的非同步任務狀態
/v1/videos/generations/{id}GET相容舊版的影片任務狀態路徑
對於新客戶，建議優先使用 /v1/tasks/{id}，並追蹤建立回應時所回傳的 poll_url。保留 /v1/videos/generations/{id} 僅作向後相容之用。

​
非同步任務

EndpointMethodDescription
/v1/tasks/{id}GET統一的非同步任務狀態端點。當追蹤回傳的 poll_url 時建議使用
此端點不限於影片、音樂與 3D。一些影像任務也可能使用 /v1/tasks/{id} 作為標準的輪詢路徑。

​
音樂

EndpointMethodDescription
/v1/music/generationsPOST建立音樂生成任務
/v1/music/generations/{id}GET音樂專用的狀態路徑
對於新客戶，建議優先追蹤回傳的 poll_url。若需要固定的任務狀態端點，請使用 /v1/tasks/{id}；保留 /v1/music/generations/{id} 以支援音樂專用的相容性路徑。

​
3D 生成

EndpointMethodDescription
/v1/3d/generationsPOST建立 3D 模型生成任務
/v1/3d/generations/{id}GET3D 專用的狀態路徑
對於新客戶，建議優先追蹤回傳的 poll_url。若需要固定的任務狀態端點，請使用 /v1/tasks/{id}；保留 /v1/3d/generations/{id} 以支援 3D 專用的相容性路徑。

​
模型

EndpointMethodDescription
/v1/modelsGET列出所有可用的模型
/v1/models/{model}GET取得特定模型資訊

​
Gemini (v1beta)

原生支援 Google Gemini API 格式：
EndpointMethodDescription
/v1beta/models/{model}:generateContentPOST生成內容（Gemini 格式）
/v1beta/models/{model}:streamGenerateContentPOST串流生成內容（Gemini 格式）
Gemini 端點除了標準的 Bearer token 驗證外，亦支援使用 ?key= 查詢參數進行認證。

​
回應格式

所有回應遵循一致的格式：

​
成功回應

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

​
路由透明性

所有回應都包含帶有頻道資訊的 _routing 欄位： 
{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}
欄位說明
channel.id使用的頻道識別碼
channel.provider上游提供者（openai、anthropic 等）
channel.channelTypePLATFORM（LemonData）或 PRIVATE（BYOK）
cached回應是否由快取提供
retryCount重試次數（如有）

​
錯誤回應

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

​
速率限制

速率限制依角色而定，且可由管理員設定。預設值：
角色請求/分鐘
使用者60
合作夥伴300
VIP1,000
若需自訂速率限制，請聯絡客服。實際數值可能因帳戶設定而異。
當超過速率限制時，API 會回傳 429 狀態碼並在回應中包含 Retry-After 標頭，指示需等待的時間。

​
OpenAPI 規格

OpenAPI 規格

下載完整的 OpenAPI 3.0 規格