众扬汇 AI 开放平台 API 文档

任务

OpenAPI Specification

任务对象模型,含义与 Page«任务» 中的任务项一致,用于按任务 ID 查询单条记录时承载返回数据。接口基址为 https://api.allyang.cn,OpenAI 兼容前缀为 /v1;本页仅描述数据模型,完整访问路径以对应接口页为准。

一条任务提交后会依次流转:NOT_START → SUBMITTED → IN_PROGRESS → SUCCESS 或 FAILURE;其中 action 决定任务的业务类型,status 反映实时进度,progress 为百分比形式的进度文本。时间类字段均以时间戳承载,具体单位待实测确认。

字段 类型 必填 说明
action string — 任务类型,取值 IMAGINE、UPSCALE、VARIATION、REROLL、DESCRIBE、BLEND
description string — 任务描述
failReason string — 失败原因
finishTime integer(int64) — 结束时间
id string — 任务 ID
imageUrl string — 图片地址
progress string — 任务进度
prompt string — 提示词
promptEn string — 提示词(英文)
properties object — 扩展属性容器
startTime integer(int64) — 开始执行时间
state string — 自定义参数
status string — 任务状态,取值 NOT_START、SUBMITTED、IN_PROGRESS、FAILURE、SUCCESS
submitTime integer(int64) — 提交时间

排查失败任务时优先读 failReason,成功任务则取 imageUrl;properties 与 state 原样透传调用方提交时的扩展内容。