创建与任务
所有产品共用同一条异步链路:
GET /catalogPOST /creationsGET /creations/jobs/{job_id}GET /creations/{creation_id}
创建请求只发送 Public OpenAPI schema 中列出的字段。
任务状态以 job.status 为准。成功后从详情读取 main_url、artifacts[] 和 scenes[];不要自行拼接存储地址。
使用 GET /creations 查询当前 API Key 所属用户的结果,可按正式 Public API type 过滤。
应保存哪些标识
创建响应中有两个关键标识:creation_id 指向结果,job_id 指向异步任务。应用应同时保存它们。任务接口用于查看进度、判断是否重试和处理失败;只有任务成功后,才从 creation 详情读取面向用户的结果和返回的资产。
稳定的客户端流程
先读取 /catalog,只提交一次参数有效的 POST /creations 请求。以合理间隔轮询任务,直到成功、失败或取消。成功后刷新 GET /creations/{creation_id},展示返回的 main_url、artifacts[] 和 scenes[]。这样不会在任务排队时展示猜测出的地址或不完整结果。
任务失败时保留结构化状态,并修正根因后再重试。参数校验、账号限额和提示词需要更清晰说明,处理方式并不相同;不要把同一失败 payload 变成重复任务循环。
