/api/v1/image-tasks适合即梦图片生成等长耗时任务。create请求只落库入本地队列并returns虚拟 task id；后台 worker 负责 submit/poll、落结果和计费 finalize。需要立即returns图片时使用 Create images。
Back to Images endpoint listRequest parameters
FieldTypeRequiredDescription
modelstringYesGlobalRouter 图片models ID，例如 jimeng_t2i_v31。promptstringYesImage generation prompt.input_referencesobject[]No参考图列表，每项包含 type=image_url 与 image_url.url。nintegerNo生成图片数量，默认 1，最大值按models能力配置。sizestringNoImage size. Do not provide it together with resolution or aspect_ratio.aspect_ratiostringNoAspect ratio, such as 1:1, 16:9, or 9:16.resolutionstringNo分辨率档位，例如 1K、2K、4K。qualitystringNo质量档位，例如 auto、low、medium、high。seedintegerNoRandom seed.output_formatstringNoOutput format, such as png, jpeg, or webp.response_formatstringNoreturns url 或 b64_json。provider.provider_idstringNo指定 provider，例如 doubao_gr。create时选定后，submit/poll 都固定使用该 provider。provider.optionsobjectNoProvider-keyed options，不允许包含 AK/SK。webhook_urlstringNoHTTPS webhook URL。完成或失败通知通过后台 outbox 投递。metadataobjectNo客户端元数据。req_key 不需要传，服务端由 model + provider_model_id 推导。Response fields
FieldTypeRequiredDescription
idstringYesGR 虚拟图片任务 ID，例如 imgtask_xxx。objectstringYes固定为 image.task。statusstringYesqueued、submitting、submitted、in_progress、completed、failed、expired 等。modelstringYes请求models。providerstringYescreate时固定的 provider。polling_urlstringYesquery任务状态的相对 URL。dataobject[]Nocompleted 后returns图片明细。data[].urlstringNoImage URL.data[].b64_jsonstringNoBase64 image content.usageobjectNo后台 poll worker 完成计费后的用量摘要。errorobjectNo失败原因。Errors
400
ROUTER_IMAGE_TASK_PROVIDER_RELATION_NOT_FOUNDmodels没有可用 provider 绑定或 provider_model_id/req_key 缺失。
429
ROUTER_IMAGE_TASK_QUEUE_FULL租户或 API key 的异步图片队列已满。
503
ROUTER_IMAGE_TASK_QUEUE_DISABLED异步图片任务队列已关闭。
Notes
- req_key 由服务端根据 model 和 provider_model_id 推导，普通客户端不需要传。
- 已create任务的 provider 固定在 image_tasks.provider_id，poll 阶段不会按 model 重新路由。