生成异步媒体
异步创建图片、视频或音乐任务并获取产物。
提交耗时较长的媒体生成任务，而无需保持推理请求连接。
POST
/v1/async-tasks/image-generations请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 否 | 媒体模型标识。省略时按已配置的默认服务商行为路由。 |
prompt | string | 是 | 期望输出的描述。 |
n | integer | 否 | 图片数量，范围为 1 到 10，默认值为 1。 |
seed | integer | 否 | 服务商支持时使用的非负确定性种子。 |
| 其他字段 | object | 否 | 服务商支持的尺寸和生成控制。未知顶层字段会被拒绝；服务商专用选项应放入 provider_options 或 parameters。 |
视频请求的 duration_seconds 必须大于 0 且不超过 300，fps 必须为不超过 120 的正整数。音乐请求的 duration_seconds 不得超过 1,200，并且 prompt、lyrics、title 至少填写一项。
任务流程
- 提交图片、视频或音乐生成请求。
- 保存返回的任务 ID。
- 轮询
GET /v1/async-tasks/{task_id}直到任务完成。 - 通过签名产物 URL 下载结果。
产物 URL 有有效期。如果需要长期保留，请把最终资源保存到自己的存储中。
兼容别名
现有集成可以继续使用 /v1/images/generations、/v1/videos/generations 与 /v1/music/generations。新集成应使用上面的显式 /v1/async-tasks/*-generations 路由。