メインコンテンツへスキップ
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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

このエンドポイントを使うと、テキスト、またはテキストと1枚の参照画像から新しい Sora のレンダージョブを開始できます。API はすぐに video id を返し、レンダリングの完了は待機しません。

​
まずは最小限で有用なジョブから始める

  • より素早く試行錯誤したい場合は sora-2 を、速度より出力品質を重視する場合は sora-2-pro を使用します
  • 最初のリクエストでは seconds を 4 に保ちます
  • 特に縦長出力が必要でない限り、size: 1280x720 から始めます
  • 参照画像のアップロードは最大1枚にします

​
エンドツーエンドの流れ

1

レンダージョブを作成

model、prompt、seconds、size を送信し、返された id を保存します。
2

ジョブが完了するまでポーリング

ステータスが completed または failed になるまで 動画を取得 を呼び出します。
3

結果をダウンロードまたはリミックス

レンダリングが完了したら、動画コンテンツを取得 でファイルを取得します。特定のバリエーションが必要な場合は、完了した結果に対して 動画をリミックス を使用します。

​
引き続き適用される Sora の挙動

OpenAI は Videos API でも同じ create -> retrieve -> download の流れを案内しています。CometAPI では Sora のリクエスト形式はそのまま維持されますが、CometAPI のベース URL とキーを使用します。完了後のダウンロード URL は一時的なものなので、長期間保持する必要がある場合は、完了したアセットを自分のストレージにコピーしてください。

承認

​
Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ボディ

multipart/form-data
​
prompt
string
必須

Text prompt that describes the video you want to create.

例:

"A paper airplane glides across a desk."

​
model
string
デフォルト:sora-2

Sora model ID. Choose a current model from the Models page.

例:

"sora-2"

​
seconds
enum<string>
デフォルト:4

Clip duration in seconds.

利用可能なオプション:
4,
8,
12
例:

"4"

​
size
enum<string>
デフォルト:1280x720

Output resolution formatted as width x height.

利用可能なオプション:
720x1280,
1280x720,
1024x1792,
1792x1024
例:

"1280x720"

​
input_reference
file

Optional reference image uploaded as a file. The image should match the target size you request.

レスポンス

200 - application/json

Video job accepted.

​
created_at
integer
必須
​
id
string
必須
​
model
string
必須
​
object
string
必須
​
progress
integer
必須
​
seconds
string
必須
​
size
string
必須
​
status
string
必須