查询 Veo3.1 视频生成任务的执行状态和结果。
状态说明
- 0:生成中 - 任务正在处理
- 1:成功 - 任务已成功完成
- 2:失败 - 任务生成失败
- 3:生成失败 - 任务创建成功但生成失败
重要说明
- 可通过 taskId 实时查询任务状态
- 建议定期轮询直到任务完成
- 响应中包含
fallbackFlag字段,指示是否使用了托底模型生成
响应字段说明
是否通过托底模型生成。
true 表示使用了备用模型生成,false 表示使用主模型生成托底状态识别
通过fallbackFlag 字段可以识别任务是否使用了托底模型:
true: 使用托底模型生成,视频分辨率为 720pfalse: 使用主模型生成,可能支持 1080P(16:9 宽高比)
托底模型生成的视频无法通过获取 1080P 视频接口升级到高清版本。
Authorizations
所有 API 都需要通过 Bearer Token 进行认证。
获取 API Key:
- 访问 API Key 管理页面 获取您的 API Key
使用方法: 添加到请求头: Authorization: Bearer YOUR_API_KEY
注意:
- 请妥善保管您的 API Key,不要与他人分享
- 如果您怀疑 API Key 已泄露,请立即在管理页面重置
Query Parameters
任务ID
Response
请求成功
响应状态码
- 200: 成功 - 请求已成功处理
- 400: 您的提示词被网站标记为违反内容政策。 仅支持英文提示词。 无法获取图片。请验证您或您的服务提供商设置的任何访问限制。 公共错误:不安全的图片上传。
- 401: 未授权 - 认证凭据缺失或无效
- 404: 未找到 - 请求的资源或端点不存在
- 422: 验证错误 - 请求参数验证失败。 记录为空。 暂时支持14天内的记录。 记录结果数据为空。 记录状态不是成功。 记录结果数据不存在。 记录结果数据为空。
- 451: 无法获取图片。请验证您或您的服务提供商设置的任何访问限制。
- 455: 服务不可用 - 系统正在进行维护
- 500: 服务器错误 - 处理请求时发生意外错误。 超时 内部错误,请稍后重试。
可用选项:
200, 400, 401, 404, 422, 451, 455, 500 响应消息
Example:
"success"
