查询任务状态
任务管理
查询任务状态
- 查询异步任务的当前状态和结果
- 任务状态流转:
pending→processing→completed/failed - 可选传入
sync_upstream=true,对仍在执行中的任务先主动刷新一次最新状态 - 任务完成后,结果链接有效期为24小时,请尽快保存
GET
查询任务状态
results 字段格式说明
任务完成(status=completed)后,results 是一个数组,结构按模型不同而异。解析结果前请先根据响应中的 model 字段判定结构类型。
通用格式(大多数模型)
按任务输出类型(type)分组:
url 有效期均为 24 小时,请尽快保存。
特殊格式(按 model 区分)
以下模型的 results[i] 结构不遵循上表通用格式。调用方必须按 model 单独处理。
档案创建类(不返回媒体 URL)
声音克隆类
语音转写类(不返回媒体 URL)
视频带种子值
seed 字段始终存在:当生成过程回传了种子时为对应整数;若本次生成未回传种子,则为 null。请按「字段始终存在、值可能为 null」处理。参考视频快速版降级提示(degraded_reason)
PBR 材质类(单任务返回多个带语义标签的结果)
音乐生成带歌词文本
文档转换类(结果为 ZIP 压缩包 URL,非媒体直链)
解析建议
- 先读
model,再解析results:同一type下不同model的结构可能完全不同 - URL 类结果注意过期:所有
url有效期 24 小时,业务侧应在收到结果后立即下载转存 - 档案类任务返回的
voice_id/character_id/profile_id是长期有效的资源标识,可直接用于后续任务参数
授权
所有接口均需要使用Bearer Token进行认证
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
路径参数
任务ID,由提交任务接口返回
示例:
"task-unified-1757165031-uyujaw3d"
查询参数
是否在返回前主动刷新一次任务状态。仅对仍在执行且已有关联远端任务的记录生效;否则直接返回当前任务状态。
示例:
true
响应
查询成功
任务ID
示例:
"task-unified-1757165031-uyujaw3d"
任务的具体类型
可用选项:
video.generation.task, image.generation.task, audio.generation.task, llm.generation.task 示例:
"video.generation.task"
任务的输出类型
可用选项:
video, image, audio, llm 示例:
"video"
实际使用的模型名称
示例:
"lipsync-2"
任务状态
可选值:
可用选项:
pending, processing, completed, failed 示例:
"pending"
任务进度百分比
必填范围:
0 <= x <= 100示例:
0
任务创建时间戳(Unix 秒)
示例:
1757165031
任务结果列表,仅在 status=completed 时有值。
结构按任务输出类型(type)不同:
通用说明:
- 结果中的 URL 有效期为 24 小时,请尽快保存
type=llm的结果是对话响应,不产生 URL- 部分任务是"非媒体产物"(创建语音档案 / 角色档案等),
results不含url而是 id 类字段
图片结果(type=image)。多数图片模型只返回 url;少数模型(Patina 家族)会附带 content_type;PHOTA 创建档案类任务返回 {result_type, profile_id}(非图片产物)
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
错误信息,仅在 status=failed 时有值
计费信息