> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sora 2

> Sora 2：同期音声を備えた動画生成モデル。MixRoute向けのリクエスト例とパラメータ。

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

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

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

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `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`を設定してください。

```bash theme={null}
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

```python theme={null}
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)
```

## ワークフロー

1. 有効なSoraルートに送信し、返されたMixRouteタスクIDを保持してください。
2. 成功または終端の失敗状態になるまで、[動画タスクの照会](/ja/api-reference/endpoint/query-video-task)をポーリングします。
3. 返された結果URLを使用してください。別のダウンロードエンドポイントが必要なルートでは、[動画のダウンロード](/ja/api-reference/endpoint/download-video)を使用してください。

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.