概览/OpenAPI/创建与任务

创建与任务

创建、轮询、列表与详情读取。

创建与任务

所有产品共用同一条异步链路:

  1. GET /catalog
  2. POST /creations
  3. GET /creations/jobs/{job_id}
  4. GET /creations/{creation_id}

创建请求只发送 Public OpenAPI schema 中列出的字段。

任务状态以 job.status 为准。成功后从详情读取 main_urlartifacts[]scenes[];不要自行拼接存储地址。

使用 GET /creations 查询当前 API Key 所属用户的结果,可按正式 Public API type 过滤。

应保存哪些标识

创建响应中有两个关键标识:creation_id 指向结果,job_id 指向异步任务。应用应同时保存它们。任务接口用于查看进度、判断是否重试和处理失败;只有任务成功后,才从 creation 详情读取面向用户的结果和返回的资产。

稳定的客户端流程

先读取 /catalog,只提交一次参数有效的 POST /creations 请求。以合理间隔轮询任务,直到成功、失败或取消。成功后刷新 GET /creations/{creation_id},展示返回的 main_urlartifacts[]scenes[]。这样不会在任务排队时展示猜测出的地址或不完整结果。

任务失败时保留结构化状态,并修正根因后再重试。参数校验、账号限额和提示词需要更清晰说明,处理方式并不相同;不要把同一失败 payload 变成重复任务循环。

关联文档