跳转到主要内容
GET
查询视频任务状态

获取任务状态

查询视频生成任务的执行状态,并在完成后获取生成的视频。

接口

认证

所有请求都需要 Bearer token 认证:

参数

路径参数

响应

成功响应(200)

响应字段

状态值

失败任务

代码示例

重要说明

轮询间隔:每 2-5 秒查询一次状态。视频生成通常需要 90-300 秒。
内容有效期:生成的视频在创建后 3 天内可访问。请及时下载并保存内容。
Webhook:除了轮询,你还可以在提交任务时提供 callback_url 来自动接收通知。参见视频 Webhook 回调。
更多语言的代码示例、带退避的轮询以及 HTTP 错误码,请参见统一任务状态页面。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

路径参数

task_id
string
必填

提交接口返回的唯一任务标识

响应

200 - application/json

任务状态

code
enum<integer>
必填

业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。

  • 200:成功
  • 400:请求参数无效
  • 401:API Key 缺失或无效
  • 402:积分不足
  • 403:没有权限
  • 404:资源不存在
  • 408:请求超时
  • 429:请求频率超限
  • 500:服务器内部错误
  • 502:上游服务错误
  • 503:服务暂不可用

详见错误码。

可用选项:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
示例:

200

data
object
必填
示例: