章鱼哥AI接口文档

文档

本系列支持的端点
  • 任务查询GET https://zexapi.com/v1/videos/{task_id}
GEThttps://zexapi.com/v1/videos/{task_id}
鉴权 Authorization: Bearer YOUR_API_KEY

使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。

任务查询接口文档

接口地址

GET /v1/videos/{task_id}

功能说明

查询视频生成和图片生成任务的状态和结果(适用于Sora、Veo、图片生成等所有任务)

请求头

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY

路径参数

参数名类型必填说明
task_idstring是任务ID,由提交接口返回

请求示例

curl -X GET https://xxx.com/v1/videos/task_xxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

响应参数

参数名类型说明
idstring任务ID
objectstring对象类型:video(视频)或 image(图片)
modelstring使用的模型名称
statusstring任务状态:queued(排队中)、processing(处理中)、completed(已完成)、failed(失败)
progressnumber任务进度,0-100
created_atnumber创建时间戳(秒)
completed_atnumber完成时间戳(秒,仅completed状态返回)
urlstring结果URL(仅completed状态返回),视频或图片的下载地址
errorstring错误信息(仅failed状态返回)

响应示例

排队中

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-landscape-10s",
  "status": "queued",
  "progress": 0,
  "created_at": 1709876543
}

处理中

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "veo_3_1-fast",
  "status": "processing",
  "progress": 45,
  "created_at": 1709876543
}

已完成(视频)

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-landscape-10s",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "url": "https://example.com/videos/xxx.mp4"
}

已完成(图片 - Nano Banana)

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

失败

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-landscape-10s",
  "status": "failed",
  "progress": 0,
  "created_at": 1709876543,
  "error": "生成失败:内容违规"
}

错误码说明

HTTP状态码说明
200请求成功
404任务不存在
401未授权
500服务器内部错误

注意事项

1.
轮询建议:建议每3-5秒轮询一次任务状态,避免过于频繁的请求
2.
任务状态流转:queued → processing → completed/failed
3.
结果获取:只有当 status 为 completed 时,才会返回 url 字段
4.
通用接口:此接口适用于所有通过 /v1/videos 提交的任务(Sora视频、Veo视频、Nano Banana图片生成等)
5.
任务保留:已完成的任务会保留一段时间,建议及时下载结果