非同期メディアを生成する
画像、動画、または音楽のジョブを作成し、それらのアーティファクトを非同期で取得します。
推論リクエストを開いたままにせずに、時間のかかるメディア生成ジョブを送信します。
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つ以上が必要です。
タスクのライフサイクル
- 画像、動画、または音楽生成リクエストを送信します。
- 返されたタスクIDを保存します。
- タスクが完了するまで
GET /v1/async-tasks/{task_id}をポーリングします。 - 署名されたアーティファクトURLから出力をダウンロードします。
アーティファクトURLには有効期限があります。長期保存が必要な場合は、最終的なアセットをご自身のストレージに永続化してください。
互換性エイリアス
既存の統合では /v1/images/generations、/v1/videos/generations、/v1/videos、/v1/music/generations、/v1/audio/generations、および /openai/v1/audio/generations を引き続き使用できます。新しい統合では上記の明示的な /v1/async-tasks/*-generations ルートを使用する必要があります。