影片(Video)
查詢影片 API
查詢 Veo 影片任務狀態並獲取生成結果
Veo 影片採用非同步任務模式。提交任務後,介面會立即返回任務 id,客戶端需要使用該 id 查詢狀態,直到任務完成或失敗。
GET /v1/videos/{id}curl 'https://88api.ai/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Authorization: Bearer sk-xxxx'任務狀態
| 狀態 | 說明 |
|---|---|
queued | 任務排隊中 |
processing | 正在生成 |
completed | 生成成功,讀取 video_url |
failed | 生成失敗,讀取 error |
建議每隔 5~10 秒查詢一次,總超時時間不少於 600 秒。
不要因為任務還在排隊或生成中就重複提交建立請求。重複提交會建立新的任務,可能產生額外扣費。
成功響應
{
"id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
"model": "veo-3.1-fast",
"status": "completed",
"video_url": "https://example-bucket.s3.amazonaws.com/video.mp4?...",
"created_at": 1786106645
}完成後直接使用 video_url 下載影片。該地址通常帶有有效期,請及時儲存。
失敗響應
{
"id": "task_xxxxxxxxxxxxxxxxxxxxxxxx",
"status": "failed",
"error": {
"code": "generation_failed",
"message": "影片生成失敗"
}
}完整的提交、輪詢和 JavaScript 示例請參閱 Veo 影片 API;只想複製示例可以檢視 影片 API 使用示例。