生成非同步媒體

非同步建立圖片、影片或音樂任務並擷取其成品。

提交耗時的媒體生成工作,而無需保持推論請求開啟。

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 中的至少一個。

任務生命週期

  1. 提交圖片、影片或音樂生成請求。
  2. 儲存返回的任務 ID。
  3. 輪詢 GET /v1/async-tasks/{task_id} 直到任務完成。
  4. 透過簽署的成品 URL 下載輸出。

成品 URL 有時間限制。若需要長期保留,請將最終資產儲存在您自己的儲存空間中。

相容性別名

現有整合可以繼續使用 /v1/images/generations、/v1/videos/generations、/v1/videos、/v1/music/generations、/v1/audio/generations 與 /openai/v1/audio/generations。新整合應使用上面的顯式 /v1/async-tasks/*-generations 路由。