Sora 2

Sora 2は、同期された音声付きの動画を生成します。MixRouteルートでは、以下のSora作成フィールドとPOST /v1/video/generationsを使用します。

OpenAIは、Sora 2モデルおよびVideos APIの提供終了を2026年9月24日に予定しています。統合前にMixRouteルートへのアクセスを確認してください。カタログにモデルIDがあるだけでは、動画ルートが有効であることや、上流での提供終了後も継続して利用できることは保証されません。

リクエストパラメーター

フィールド	型	必須	説明
`model`	string	はい	`sora-2`を使用してください。
`prompt`	string	はい	シーン、動き、希望する音声を記述してください。
`seconds`	string	いいえ	クリップの長さ：“4”、“8”、または”12”。デフォルトは”4”です。これは文字列であり、長さを表す整数ではありません。
`size`	string	いいえ	Sora 2には`720x1280`（デフォルト、縦向き）または`1280x720`（横向き）を使用してください。正方形出力やPro専用サイズが使えると推測しないでください。
`input_reference`	object \| file	いいえ	ネイティブの最初のフレーム入力：image_urlまたはfile_idを持つJSONオブジェクト、またはマルチパートアップロード。選択したMixRouteルートで、メディア入力のサポートが有効になっている必要があります。

これらはSoraのトップレベルのフィールドです。Seedance形式のduration、resolution、aspect_ratioで置き換えたり、metadataで囲んだりしないでください。参照画像は、リクエストしたサイズと一致し、JPEG、PNG、WebPのいずれかである必要があります。JSONでのネイティブ形式はinput_reference: {"image_url": "..."}またはinput_reference: {"file_id": "..."}であり、トップレベルのimage_urlではありません。ファイルIDは上流アカウントからアクセスできる必要があります。リミックスは独立した動画操作であり、作成リクエストのremix_urlフィールドではありません。任意のソースURLをそのフィールドとして流用しないでください。

テキストから動画を生成

呼び出し前に、環境変数MIXROUTE_API_KEYを設定してください。

curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "sora-2",
  "prompt": "A red paper square slowly rotates on a plain white background.",
  "seconds": "4",
  "size": "720x1280"
}'

Python

import json
import os
import requests

payload = json.loads(r'''
{
  "model": "sora-2",
  "prompt": "A red paper square slowly rotates on a plain white background.",
  "seconds": "4",
  "size": "720x1280"
}
''')
response = requests.post(
    "https://api.mixroute.ai/v1/video/generations",
    headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
    json=payload,
    timeout=60,
)
response.raise_for_status()
result = response.json()
if result.get("code") not in (None, 0, 200, "0", "200", "success"):
    raise RuntimeError(result.get("message") or result)
print(result)

ワークフロー

有効なSoraルートに送信し、返されたMixRouteタスクIDを保持してください。
成功または終端の失敗状態になるまで、動画タスクの照会をポーリングします。
返された結果URLを使用してください。別のダウンロードエンドポイントが必要なルートでは、動画のダウンロードを使用してください。

HTTPエラーやアプリケーションレベルのエラーは、タスクが作成されたことを意味しません。プラットフォームのルーティングエラーにはルート設定の修正が必要です。プロンプトを変更したり、ドキュメントに記載されていないフィールドを追加したりしても解決しません。

ホーム

モデル紹介

リクエストパラメーター

テキストから動画を生成

Python

ワークフロー

​リクエストパラメーター

​テキストから動画を生成

​Python

​ワークフロー

リクエストパラメーター

テキストから動画を生成

Python

ワークフロー