Skip to main content
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 是长期有效的资源标识,可直接用于后续任务参数

授权

Authorization
string
header
必填

所有接口均需要使用Bearer Token进行认证

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

路径参数

task_id
string
必填

任务ID,由提交任务接口返回

示例:

"task-unified-1757165031-uyujaw3d"

查询参数

sync_upstream
boolean
默认值:false

是否在返回前主动刷新一次任务状态。仅对仍在执行且已有关联远端任务的记录生效;否则直接返回当前任务状态。

示例:

true

响应

查询成功

id
string

任务ID

示例:

"task-unified-1757165031-uyujaw3d"

object
enum<string>

任务的具体类型

可用选项:
video.generation.task,
image.generation.task,
audio.generation.task,
llm.generation.task
示例:

"video.generation.task"

type
enum<string>

任务的输出类型

可用选项:
video,
image,
audio,
llm
示例:

"video"

model
string

实际使用的模型名称

示例:

"lipsync-2"

status
enum<string>

任务状态

可选值:

可用选项:
pending,
processing,
completed,
failed
示例:

"pending"

progress
integer

任务进度百分比

必填范围: 0 <= x <= 100
示例:

0

created
integer

任务创建时间戳(Unix 秒)

示例:

1757165031

results
object[] | null

任务结果列表,仅在 status=completed 时有值。

结构按任务输出类型(type)不同:

通用说明:

  • 结果中的 URL 有效期为 24 小时,请尽快保存
  • type=llm 的结果是对话响应,不产生 URL
  • 部分任务是"非媒体产物"(创建语音档案 / 角色档案等),results 不含 url 而是 id 类字段

图片结果(type=image)。多数图片模型只返回 url;少数模型(Patina 家族)会附带 content_type;PHOTA 创建档案类任务返回 {result_type, profile_id}(非图片产物)

error
object | null

错误信息,仅在 status=failed 时有值

usage
object | null

计费信息