非同期メディアを生成する
画像、動画、または音楽のジョブを作成し、それらのアーティファクトを非同期で取得します。
推論リクエストを開いたままにせずに、時間のかかるメディア生成ジョブを送信します。
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/music/generationsが使用される場合があります。新しい統合では、上記の明示的な/v1/async-tasks/*-generationsルートを使用する必要があります。