任务

任务是图像、视频、音频和未来模型组共用的执行单位。

生命周期

状态查询

通过 GET /api/omni/tasks/{portal_task_id} 查询单个任务，或通过 POST /api/omni/tasks/status-batch 批量查询多个活动任务。任务进入 completed、failed 或 canceled 后停止轮询。

批量查询示例：

{
  "portal_task_ids": ["portal_task_..."]
}

Public API 不提供预计等待时间或全局排队名次。产品控制台可以显示范围受限的队列快照，但该私有 UI 投影不属于 Public API 合同。

输出

任务进入 completed 后，通过 GET /api/omni/tasks/{portal_task_id}/output-urls 获取最新的图像、视频或音频下载地址。每个输出项包含自己的访问方式和有效期字段。文本和 JSON 结果直接保留在任务的 outputs 数组中。

优先级

任务使用三档优先级：

• 0：由受支持网站链路创建的 Eco 图像任务。
• 1：普通 fast 积分任务。
• 2：已成功扣除插队费用的加速任务。

Public API 使用 API Key 创建任务，只接受 Fast 积分。credits_intent 可以省略或设为 fast；提交 eco 会在创建任务和扣费前被拒绝。网站登录用户和 API Console Playground 对支持的图像任务仍可选择 Fast 或 Eco。Worker 会按优先级桶做概率取样，不会只清空最高优先级队列；网站 Eco 任务会更慢，但不应长期饿死。

取消和补偿

任务被 worker 领取前可以取消，取消和符合条件的全额退分在同一事务内完成。用户不能取消 running 任务。任务失败或 GPU 执行阶段超过 runtime deadline 时，系统自动且仅补偿一次。不设置排队超时，也不提供人工补偿动作。