生成非同步媒體
非同步建立圖片、影片或音樂任務並擷取其成品。
提交耗時的媒體生成工作，而無需保持推論請求開啟。
POST
/v1/async-tasks/image-generations請求內文
| 欄位 | 類型 | 必要 | 說明 |
|---|---|---|---|
model | 字串 | 否 | 媒體模型識別碼。省略時，路由會使用設定的預設提供者行為。 |
prompt | 字串 | 是 | 所需輸出的說明。 |
n | 整數 | 否 | 從 1 到 10 的圖片計數；預設為 1。 |
seed | 整數 | 否 | 支援時的非負確定性種子。 |
| 其他欄位 | 物件 | 否 | 提供者支援的維度和產生控制項。未知的頂層欄位會被拒絕；提供者特定的選項屬於 provider_options 或 parameters。 |
影片請求接受長度最多為 300 的正整數 duration_seconds 和長度最多為 120 的正整數 fps。音樂請求接受長度最多為 1,200 的 duration_seconds，並需要 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 路由。