公式API
動画を作成
POST /v1/videos を使用して、テキストプロンプトまたは参照画像から Sora 2 の動画生成タスクを作成し、その後タスク ID でステータスをポーリングして結果を取得します。
POST
/
v1
/
videos
Create a Sora video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}このエンドポイントを使うと、テキスト、またはテキストと1枚の参照画像から新しい Sora のレンダージョブを開始できます。API はすぐに video id を返し、レンダリングの完了は待機しません。
まずは最小限で有用なジョブから始める
- より素早く試行錯誤したい場合は
sora-2を、速度より出力品質を重視する場合はsora-2-proを使用します - 最初のリクエストでは
secondsを4に保ちます - 特に縦長出力が必要でない限り、
size: 1280x720から始めます - 参照画像のアップロードは最大1枚にします
エンドツーエンドの流れ
ジョブが完了するまでポーリング
ステータスが
completed または failed になるまで 動画を取得 を呼び出します。結果をダウンロードまたはリミックス
レンダリングが完了したら、動画コンテンツを取得 でファイルを取得します。特定のバリエーションが必要な場合は、完了した結果に対して 動画をリミックス を使用します。
引き続き適用される Sora の挙動
OpenAI は Videos API でも同じ create -> retrieve -> download の流れを案内しています。CometAPI では Sora のリクエスト形式はそのまま維持されますが、CometAPI のベース URL とキーを使用します。完了後のダウンロード 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 a current model from the Models page.
例:
"sora-2"
Clip duration in seconds.
利用可能なオプション:
4, 8, 12 例:
"4"
Output resolution formatted as width x height.
利用可能なオプション:
720x1280, 1280x720, 1024x1792, 1792x1024 例:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
Create a Sora video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}