获取任务结果

该接口可通过唯一 task ID 查询指定任务的详情和当前状态。你可以通过轮询该接口跟踪已提交任务（如 image generation、text-to-model、image-to-model 等）的进度，并在任务完成后获取最终结果。

接口地址

参数

必填路径参数

task_id: 创建任务后返回的 task id。

返回值

task_id: 任务唯一标识，应与请求中传入的标识一致。

type: 任务类型。

status: 任务当前状态，分为 ongoing（处理中）与 finalized（终态）两类，共 8 种取值：

• ongoing
  • queued: 任务正在排队等待处理。
  • running: 任务正在执行中。
• finalized
  • success: 任务执行成功，可将 output 作为最终结果使用。
  • failed: 任务失败，通常由系统或输入问题导致。请先参考错误码；若仍不清楚，请携带 task_id 联系支持。
  • banned: 任务因违反内容策略被封禁。
  • expired: 任务在一定时间后过期。请重试；若再次出现请携带 task_id 联系支持。
  • cancelled: 任务已取消。
  • unknown: 当前无法确定任务状态，可能存在系统层问题。请携带 task_id 联系支持团队。

input: 输入数据对象，结构取决于 task_type。

output: 任务结果对象，可能包含：

• model: 模型下载 URL，默认 5 分钟过期。
• base_model: 基础模型下载 URL，默认 5 分钟过期。
• pbr_model: pbr 模型下载 URL，默认 5 分钟过期。
• generated_image: 生成图像 URL，默认 5 分钟过期。
• rendered_image: 模型预览图 URL，默认 5 分钟过期。
• generate_multiview_image: generate_multiview_image 与 edit_multiview_image 任务的输出对象。固定包含 4 个视角，顺序为 front、left、back、right。
  • front_view_url: 前视图下载 URL。
  • left_view_url: 左视图下载 URL。
  • back_view_url: 后视图下载 URL。
  • right_view_url: 右视图下载 URL。

progress: 任务进度数值，范围 0~100（含边界）。

• 当状态为 queued 时，值为 0。
• 当状态为 running 时，表示当前进度。
• 当状态为 success 时，值为 100。
• 其他状态下该值通常不具备参考意义。

consumed_credit: 该任务消耗的积分数量；任务失败时为 0。

queuing_num: 当前排队序号。任务不在队列中时返回 -1。

running_left_time: 预计剩余运行时间（秒）。任务已进入终态时返回 -1。

create_time: 任务创建时间戳。

重要说明

• 须使用同一 API Key 查询：查询任务必须使用发起该任务时所用的同一 API Key。若使用不同的 Key（即使属于同一用户）进行查询，接口将返回"任务不存在"错误。
• output 可能含未记录字段：output 字段偶尔会包含额外的、未在文档中列出的字段。这些字段不稳定且不保证始终存在——请勿将其用于关键业务逻辑。