sora-2
Sora 2 動画を作成する
POST /v1/videos を使用して、テキストプロンプトまたは参照画像から Sora 2 の動画生成タスクを作成し、その後 task ID でステータスをポーリングして結果を取得します。
POST
このエンドポイントを使用すると、テキストから、またはテキストと 1 枚の参照画像から Sora のレンダージョブを開始できます。API はすぐに video id を返し、レンダリングの完了は待ちません。
最小限で有用なジョブから始める
- より素早く反復したい場合は
sora-2を、速度よりも出力品質を重視する場合はsora-2-proを使用します - 最初のリクエストでは
secondsを4にします - 縦長出力が明確に必要でない限り、
size: 1280x720から始めます - 参照画像は最大 1 枚までアップロードします
Duration and size
Sora では、
size フィールドに正確な WxH 形式が必要です。720p のような解像度トークンや 16:9 のような比率ラベルは、このエンドポイントでは有効な Sora size 値ではありません。
エンドツーエンドのフロー
1
レンダージョブを作成する
model、prompt、seconds、size を送信し、返された id を保存します。2
ジョブが完了するまでポーリングする
ステータスが
completed または failed になるまで Retrieve Video を呼び出します。3
結果をダウンロードする
レンダリングが完了したら、Retrieve Video Content でファイルを取得します。
引き続き適用される Sora の挙動
OpenAI は Videos API で同じ create -> retrieve -> download のフローを文書化しています。CometAPI では Sora のリクエスト形状をそのまま維持しつつ、CometAPI の base URL と key を使用します。完了後のダウンロード URL は一時的なものなので、長期保存が必要な場合は、完了済みアセットを自分のストレージにコピーしてください。承認
Bearer token authentication. Use your CometAPI key.
ボディ
multipart/form-data
Text prompt that describes the video you want to create.
例:
"A paper airplane glides across a desk."
Sora model ID. Choose an available model from the Models page.
例:
"sora-2"
Clip duration in seconds. Use 4, 8, 12, 16, or 20.
利用可能なオプション:
4, 8, 12, 16, 20 例:
"4"
Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.
利用可能なオプション:
720x1280, 1280x720, 1024x1792, 1792x1024 例:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.