> ## 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.

# 動画APIの概要

> 動画モデルファミリーを選択し、共通の非同期エンドポイントとKlingのネイティブワークフローの違いを確認します。

以下から動画モデルファミリーを選択して、リクエストスキーマと例を確認してください。大半のファミリーでは共通の非同期エンドポイントを使用します。Klingは個別のネイティブエンドポイントとタスク照会を使用し、レスポンス構造も異なります。

## 動画モデルファミリー

| ファミリー | パラメータリファレンス | リクエスト構造 |
| - | - | - |
| Seedance | [Seedance](/ja/api-reference/endpoint/seedance) | `model`、`prompt`、`asset`に加え、ベンダーのすべての生成フィールドには`metadata`を使用します。 |
| Doubao | [Doubao](/ja/api-reference/endpoint/doubao) | `doubao-seedance-*`ルート。トップレベルに`model`/`prompt`/`asset`を配置し、プロバイダーのフィールドは`metadata`内に配置します。 |
| Dreamina | [Dreamina](/ja/api-reference/endpoint/dreamina) | `dreamina-seedance-*`ルート。トップレベルに`model`/`prompt`/`asset`を配置し、プロバイダーのフィールドは`metadata`内に配置します。 |
| Google Veo | [Veo](/ja/api-reference/endpoint/veo) | トップレベルの`model`/`prompt`と、metadata内でフラットに配置する`metadata.durationSeconds`、`metadata.aspectRatio`など。 |
| MiniMax H3 | [MiniMax H3](/ja/api-reference/endpoint/minimax-h3) | トップレベルに`model`/`prompt`を配置し、H3のフィールドは`metadata.content`、`metadata.resolution`、`metadata.duration`、`metadata.ratio`の下に配置します。 |
| Wan | [Wan](/ja/api-reference/endpoint/wan) | modelはルートに配置し、ネイティブのinputとparametersはmetadata内にネストします。 |
| Kling | [KlingネイティブAPI](/ja/api-reference/endpoint/kling) | /kling/...を使用します。モデルはパスに指定し、ネイティブのsettings/options/contentsを使用します。metadataは使用しません。 |
| OpenAI Sora 2 | [Sora 2](/ja/model-api/openai/sora-2) | 専用のモデルページとダウンロードエンドポイントを参照してください。 |
| Gemini Omni | [Gemini Omni](/ja/model-api/google/gemini-omni-1.1-flash) | 専用のモデルページを参照してください。Veoの生成フィールドを流用しないでください。 |

## エンドポイントと認証

| 操作 | メソッドとURL |
| - | - |
| タスクを作成 | `POST https://api.mixroute.ai/v1/video/generations` |
| タスクの照会 | `GET https://api.mixroute.ai/v1/video/generations/{task_id}` |
| Soraのダウンロード | `GET https://api.mixroute.ai/v1/video/generations/download?id={task_id}` |

上記の共通エンドポイントと以下のワークフローはKlingには適用されません。Klingでは、送信時の`data.id`を保存し、[Klingタスクの照会](/ja/api-reference/endpoint/kling-tasks)を使用してsucceededとoutputs\[].urlを読み取ってください。

```http theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

アカウントの[モデルマーケットプレイス](https://console.mixroute.ai/models)または[モデル一覧](/ja/api-reference/endpoint/list-models)にある、正確な`model`識別子を使用してください。ベンダーがリリースしただけでは、MixRouteで利用できるとは限りません。

## ワークフロー

1. ファミリーのページを選択し、そのモデルのリクエストを作成します。
2. 送信し、MixRouteの`task_id`を保持します（一部のルートでは`id`も返されます）。
3. 成功するか、最終的な失敗状態になるまで、[動画タスクの照会](/ja/api-reference/endpoint/query-video-task)を使用してください。送信の成功は、動画の生成が完了したことを意味しません。
4. 利用するルートが返す結果URLを読み取ってください。別のダウンロードエンドポイントが必要なSoraルートでは、[動画のダウンロード](/ja/api-reference/endpoint/download-video)を使用してください。

## 送信時のレスポンス

ゲートウェイのレスポンス例:

```json theme={null}
{
  "task_id": "TASK_ID",
  "id": "TASK_ID",
  "object": "video",
  "model": "dreamina-seedance-2-0-260128",
  "status": "queued"
}
```

<Note>
  送信時のタスクIDを保持し、上流のオペレーション名やファイルIDに置き換えないでください。送信後のタイムアウトは、タスクが作成されなかった証拠にはなりません。有料タスクの重複を避けるため、再送信する前にコンソールを確認してください。
</Note>


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