异步任务查询

用于查询通过异步图片任务提交接口返回的 task_id 结果。

接口

• GET /v1/videos/{task_id}

用途

适用于 香蕉模型（异步） 提交后的结果查询。

请求头

Authorization: Bearer sk-xxxxxx

路径参数

参数	类型	必填	说明
task_id	string	是	提交任务时返回的任务 ID

示例

curl --request GET \
  --url 'https://bigbangtoken.com/v1/videos/task_xxxxxxxxxxxxx' \
  --header 'Authorization: Bearer sk-xxxxxx'

常见状态

• queued
• processing
• in_progress
• completed
• failed

常见返回字段

• id
• object
• model
• status
• progress
• created
• created_at
• completed_at
• url
• error

响应示例

排队中

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "image",
  "model": "nano_banana_2-异步",
  "status": "queued",
  "progress": 0,
  "created": 1709876543
}

已完成

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "image",
  "model": "nano_banana_2-异步",
  "status": "completed",
  "progress": 100,
  "created": 1709876543,
  "completed_at": 1709876580,
  "url": "https://example.com/images/xxx.jpg"
}

失败

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "image",
  "model": "nano_banana_2-异步",
  "status": "failed",
  "progress": 100,
  "created": 1709876543,
  "error": {
    "message": "生成失败：内容违规",
    "code": "upstream_error"
  }
}

计费

• 查询不重复扣费

注意事项

• 轮询建议 3-5 秒一次
• 结果字段以上游为准

相关文档

• 图片2 接入总览
• 香蕉模型（异步）