跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
概覽

使用此端點對影片、影像、音樂與 3D 生成等任務類型進行統一的非同步輪詢。 如果建立回應包含 poll_url，請呼叫該精確路徑。某些影像模型可能會在影像專用的狀態路徑或 /v1/tasks/{id} 下回傳基於任務的回應。

​
路徑參數

​
id
string
必填
由建立請求返回的任務 ID。

​
回應

​
id
string
標準的非同步任務識別碼。
​
task_id
string
非同步任務識別符別名。
​
poll_url
string
當建立回應提供時，首選的輪詢 URL。
​
status
string
任務狀態，例如 pending、processing、completed 或 failed。已取消的任務會表示為 failed 並帶有 cancelled: true。
​
cancelled
boolean
排隊中的非同步任務在執行前被取消時為 true。
​
cancellation_status
string
取消標記。取消成功時為 cancelled。
​
data
array
對於已完成的圖片任務，生成的圖片結果會在這裡返回。圖片任務會在 data[].url 中返回 URL。
​
progress
number
可用時的進度百分比。
​
video_url
string
任務完成並產生影片時的結果資產 URL。
​
video
object
單一影片載荷，包含 url、duration、width 與 height（若可用）。
​
videos
array
存在多於一個輸出時的多個影片載荷。
​
error
string
任務失敗時的錯誤訊息。
​
created
integer
可用時的建立時間戳。
​
updated
integer
可用時的最後更新時間戳。
​
model
string
可用時任務使用的模型。

​
錯誤行為

如果任務不再存在、已過期，或無法透過公開的 async-task 合約解析，LemonData 會回傳： 
{
  "error": {
    "message": "Task not found or no longer available.",
    "type": "invalid_request_error",
    "code": "async_task_not_found"
  }
}

​
範例

curl "https://api.lemondata.cc/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
Python
import requests

poll_url = "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
response = requests.get(
    f"https://api.lemondata.cc{poll_url}",
    headers={"Authorization": "Bearer sk-your-api-key"},
)
print(response.json())
JavaScript
const pollUrl = '/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa';
const response = await fetch(`https://api.lemondata.cc${pollUrl}`, {
  headers: { Authorization: 'Bearer sk-your-api-key' },
});
console.log(await response.json());