Documentation Index Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
Use this file to discover all available pages before exploring further.
路径参数 从创建视频请求返回的任务 ID。将 id 和 task_id 视为相同的异步标识。
如果创建响应返回 poll_url，请调用该精确 URL。当它指向 /v1/tasks/{id} 时，将其视为规范的固定状态端点。 如果任务不再存在或无法通过公共异步任务契约解析，TokenLab 将返回 async_task_not_found，并带有消息 Task not found or no longer available.
当结算已经完成时返回 TokenLab 账单交易 ID。它对应 dashboard / 对账使用的交易标识，与异步 id / task_id 不同。
任务状态：pending、processing、completed、failed。
单个视频负载，在可用时包含 url、duration、width 和 height。
cURL
Python
JavaScript
Go
PHP
curl "https://api.tokenlab.sh/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.tokenlab.sh/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" )
