路徑參數 從建立影片請求回傳的任務 ID。將 id 與 task_id 視為相同的非同步識別碼。
如果 create 回應回傳 poll_url，請呼叫該 URL。本當它指向 /v1/tasks/{id} 時，視為固定的標準狀態端點。 如果該任務不再存在或無法透過公開的非同步任務協定解析，LemonData 會回傳 async_task_not_found 並附上訊息 Task not found or no longer available.
任務狀態：pending、processing、completed、failed。
單一影片資料，當可用時包含 url、duration、width 與 height。
cURL
Python
JavaScript
Go
PHP
curl "https://api.lemondata.cc/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ -H "Authorization: Bearer sk-your-api-key"
Response (pending)
Response (processing)
Response (completed)
Response (failed)
{ "id" : "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" , "task_id" : "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" , "poll_url" : "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" , "status" : "pending" , "progress" : 0 , "model" : "sora-2" , "created" : 1706000000 , "updated" : 1706000000 }
輪詢最佳做法
每 5 到 10 秒輪詢一次
對於較長的任務實作指數退避
設定最大逾時（例如：10 分鐘）
優雅地處理 failed 狀態
import time def wait_for_video ( task_id , max_wait = 600 , interval = 5 ): """Wait for video with timeout.""" start = time.time() while time.time() - start < max_wait: response = requests.get( f "https://api.lemondata.cc/v1/tasks/ { task_id } " , headers = { "Authorization" : "Bearer sk-your-api-key" } ) data = response.json() if data[ "status" ] == "completed" : return data[ "video_url" ] elif data[ "status" ] == "failed" : raise Exception (data.get( "error" , "Video generation failed" )) time.sleep(interval) raise TimeoutError ( "Video generation timed out" )
