88API88API
使用指南AI 應用API 文件幫助支援
影片(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 使用示例