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

# 動画の生成

> OpenAI Sora 互換形式の動画生成インターフェース。テキストから動画の生成と、画像/動画参照による生成モードに対応しています。

- `POST /v1/videos`：動画タスクの作成
- `GET /v1/videos/{video_id}`：タスクステータスの照会
- `GET /v1/videos/{video_id}/content`：動画のバイナリコンテンツを取得

現在は外部に提供されていません：
- `GET /v1/videos`
- `POST /v1/videos/{video_id}/remix`

標準認証ヘッダー：
- `Content-Type: application/json`

1. `POST /v1/videos` でタスクを作成し、`id` を取得
2. `GET /v1/videos/{id}` を `completed` または `failed` になるまでポーリング
3. 完了後は、レスポンス内の `video_url` を優先して使用
4. 統一的にダウンロードする必要がある場合は、`GET /v1/videos/{id}/content` を呼び出す

主要パラメータ：
- `model: string`：必須、外部向けモデル名
- `prompt: string`：推奨、動画生成の説明
- `seconds: number|string`：任意、目標の長さ
- `duration: number|string`：任意、長さのエイリアス
- `size: string`：任意、出力サイズ
- `mode: string`：任意、一般的な値 `t2v` `i2v` `i2v_first_last` `reference_material`

よく使われる互換パラメータ：
- `aspect_ratio`
- `ratio`
- `quality`
- `resolution`
- `fps`
- `image`
- `image_url`
- `image_urls`
- `images`
- `reference_images`
- `input_reference`
- `end_image_url`
- `last_image_url`
- `video_urls`
- `audio_urls`
- `function_mode`
- `content`
- `callback_url`
- `external_task_id`

Kling のよく使う拡張パラメータ：
- `model_name`
- `negative_prompt`
- `cfg_scale`
- `sound`
- `camera_control`
- `image_list`
- `video_id`
- `task_id`
- `watermark_info`

### 4.1 Veo シリーズ

説明：`stable`、`official` などは異なるグループを示しており、外部向けの `model` サフィックスではありません。呼び出し時は `model` をベースモデル名のままにしてください。実際にどのグループが使われるかは、アカウントまたはトークンのグループによって決まります。

#### Veo 3.x メインモデル

- `veo3`
- `veo3-fast`
- `veo3-fast-frames`
- `veo3-frames`
- `veo3-pro`
- `veo3-pro-frames`
- `veo3.1`
- `veo3.1-fast`
- `veo3.1-pro`
- `veo3.1-components`
- `veo3.1-4k`
- `veo3.1-pro-4k`

推奨:
- テキストのみから動画を生成する場合は、`veo3*` / `veo3.1*` メインモデルを優先して使用
- 画像からの動画生成や参照ベースの動画生成シーンでは、`mode + image_url/reference_images` を明示的に渡すことを推奨

### 4.2 Sora シリーズ

基本モデル：
- `sora-2`
- `sora-2-pro`

推奨:
- `sora-2*` は汎用的な呼び出しに適しています
- `stable` / `official` などのグループを使用する場合は、`model` をベースモデル名のままにし、モデル名の末尾にサフィックスを追加しないでください。

リクエスト例:

```json
{
  "size": "1280x720",
  "images": [
    "https://example.png"
  ],
  "model": "sora-2",
  "prompt": "this is an example",
  "duration": 12,
  "fps": "24",
  "seed": "20231024",
  "mode": "i2v"
}
```

### 4.3 HappyHorse シリーズ

公開モデル：
- `happyhorse-1.0`

推奨:
- `happyhorse-1.0` は `mode` によって `t2v`、`i2v`、`r2v`、`video_edit` を区別します。
- Sora 互換形式では、参考画像には `content` 配列でメディア項目を渡すことを推奨します。
- テキスト項目には `type=text` を使用し、メディア項目には `type=image_url` を使用します。必要に応じて `role`、`name` と組み合わせて素材の用途を示せます。

リクエスト例:

```json
{
  "size": "720x1280",
  "model": "happyhorse-1.0",
  "mode": "r2v",
  "prompt": "this is an example",
  "duration": 15,
  "content": [
    {
      "type": "text",
      "text": "this is an example"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.png"
      },
      "role": "reference_image",
      "name": "image1"
    }
  ],
  "parameters": {
    "resolution": "720P",
    "ratio": "9:16",
    "duration": 15,
    "seed": 1
  }
}
```

### 4.4 Seedance シリーズ

公開モデル：
- `doubao-seedance-1-0-lite-t2v-250428`
- `doubao-seedance-1-0-lite-i2v-250428`
- `doubao-seedance-1-0-pro-250528`
- `doubao-seedance-1-0-pro-fast-251015`
- `doubao-seedance-1-5-pro-251215`
- `doubao-seedance-2-0-260128`
- `doubao-seedance-2-0-fast-260128`

推奨:
- テキストから動画を生成する場合は、`*-t2v-*` または `pro / fast` を優先してください
- 画像から動画を生成する場合は、`*-i2v-*` を優先してください
- 複雑な参考素材を用いるシナリオでは、`content` を優先して使用してください

リクエスト例:

```json
{
  "size": "1280x720",
  "model": "doubao-seedance-2-0-fast-260128",
  "prompt": "this is an example",
  "duration": 15,
  "fps": "24",
  "seed": "20231024",
  "mode": "reference_material",
  "content": [
    {
      "type": "text",
      "text": "this is an example"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.png"
      },
      "role": "reference_image",
      "name": "image1"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.mp3"
      },
      "role": "reference_audio",
      "name": "audio1"
    }
  ]
}
```

### 4.5 Grok ビデオシリーズ

公開モデル：
- `grok-imagine-1.0-video`
- `grok-imagine-video-1.5-preview`
- `grok-video-3`

よく使うパラメータ：
- `prompt`
- `ratio` / `aspect_ratio`
- `resolution` / `size`
- `seconds` / `duration`
- `image` / `image_url` / `input_reference`
- `reference_images`

例:

```json
{
  "model": "grok-imagine-1.0-video",
  "prompt": "雨夜霓虹街道上的电影感推镜，光影丰富，运动自然",
  "reference_images": [
    "https://example.com/ref-1.jpg"
  ],
  "seconds": 10,
  "aspect_ratio": "16:9",
  "resolution": "720P"
}
```

### 4.6 Kling ビデオメインモデル

公開メインモデル：
- `kling-video`

必須：
- `model`
- `model_name`

サポートされる `model_name`：
- `kling-v1`
- `kling-v1-5`
- `kling-v1-6`
- `kling-v2-master`
- `kling-v2-1`
- `kling-v2-1-master`
- `kling-v2-5-turbo`
- `kling-v2-6`
- `kling-v3`

一般的な `mode`:
- `t2v`
- `i2v`
- `multi_i2v`
- `extend`

最小入力パラメータ：
- テキストから動画: `model + model_name + prompt + mode=t2v`
- 画像から動画: `model + model_name + prompt + mode=i2v + image`
- 複数画像参照: `model + model_name + prompt + mode=multi_i2v + image_list`
- 動画の延長: `model + model_name + mode=extend + video_id`

例:

```json
{
  "model": "kling-video",
  "model_name": "kling-v2-6",
  "mode": "t2v",
  "prompt": "海边日落镜头，电影感，风吹长发",
  "duration": 5,
  "aspect_ratio": "16:9"
}
```

### 4.7 MiniMax / Hailuo 動画シリーズ

公開モデル：
- `minimax-h3`
- `hailuo-2.3`

推奨:
- `minimax-h3` はテキストから動画生成、画像参照、音声参照をサポートします。`content` でテキストと素材を混在させることを推奨します。`image_urls`、`audio_urls` などの互換フィールドも使用できます。
- `hailuo-2.3` では最初のフレーム画像が必要です。`content` で `role=first_frame` の `image_url` 項目を渡すか、`image_urls` を使用して最初のフレーム画像を渡すことを推奨します。
- `minimax-h3` でよく使うのは `duration=5~15`、`resolution=1440p` です。`hailuo-2.3` でよく使うのは `duration=6` または `10`、`resolution=768p` です。

`minimax-h3` の例：

```json
{
  "model": "minimax-h3",
  "prompt": "A cinematic product video with smooth camera motion",
  "content": [
    {
      "type": "text",
      "text": "Use the product image as reference and match the rhythm of the audio."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.jpg"
      },
      "role": "reference_image",
      "name": "product"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://example.com/music.mp3"
      },
      "role": "reference_audio",
      "name": "music"
    }
  ],
  "duration": 8,
  "resolution": "1440p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
```

`hailuo-2.3` の例：

```json
{
  "model": "hailuo-2.3",
  "prompt": "The camera slowly pushes in, natural motion and cinematic lighting.",
  "content": [
    {
      "type": "text",
      "text": "The camera slowly pushes in, natural motion and cinematic lighting."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.jpg"
      },
      "role": "first_frame",
      "name": "first"
    }
  ],
  "duration": 10,
  "resolution": "768p",
  "aspect_ratio": "16:9"
}
```

- `mode=t2v`
- 最小入力パラメータ：`model + prompt`

- `mode=i2v`
- 最小入力パラメータ：`model + prompt + image_url`

- `mode=i2v_first_last`
- 最小入力パラメータ：`model + prompt + image_url + end_image_url`

- `mode=reference_images`
- 最小入力パラメータ：`model + prompt + reference_images`

- `mode=reference_material`
- 最小入力パラメータ：`model + prompt + (image_urls/video_urls/audio_urls 至少一种)`

### Gemini Omni の呼び出し方法

- `gemini-omni` は new-api の外部公開動画モデル名で、`POST /v1/videos` を直接利用できます。
- `mode=t2v`：テキストから動画を生成します。最小入力パラメータは `model + prompt` です。
- `mode=r2v`：参照画像/参照素材による生成。画像は `image`、`image_url`、`images`、`image_urls`、`reference_images`、`input_reference`、または `content` に設定できます。
- `mode=edit`：動画編集。動画は `video`、`video_url`、`videos`、または `content` に設定でき、参照画像も同時に送信できます。
- 再生時間フィールドは `seconds` または `duration` を使用でき、4 / 6 / 8 / 10 秒のいずれかに自動でマッチします。



## OpenAPI

````yaml api-reference/ja/openapi.json POST /v1/videos
openapi: 3.0.0
info:
  title: 出海营 API 参考ドキュメント
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: OpenAI形式(Chat)
  - name: OpenAI形式（Responses）
  - name: 画像生成Gemini形式
  - name: 画像生成OpenAI DALL-E形式
  - name: モデル一覧の取得
  - name: 動画生成HappyHorseとWan
  - name: 動画生成Kling形式
  - name: 動画生成OmniとVeo形式
  - name: Video generation Seedance
  - name: 動画生成Sora対応形式
  - name: Video generation Vidu
  - name: 音楽生成タスクの形式
paths:
  /v1/videos:
    post:
      tags:
        - 動画生成Sora対応形式
      summary: 動画の生成
      description: >-
        OpenAI Sora 互換形式の動画生成インターフェース。テキストから動画の生成と、画像/動画参照による生成モードに対応しています。


        - `POST /v1/videos`：動画タスクの作成

        - `GET /v1/videos/{video_id}`：タスクステータスの照会

        - `GET /v1/videos/{video_id}/content`：動画のバイナリコンテンツを取得


        現在は外部に提供されていません：

        - `GET /v1/videos`

        - `POST /v1/videos/{video_id}/remix`


        標準認証ヘッダー：

        - `Content-Type: application/json`


        1. `POST /v1/videos` でタスクを作成し、`id` を取得

        2. `GET /v1/videos/{id}` を `completed` または `failed` になるまでポーリング

        3. 完了後は、レスポンス内の `video_url` を優先して使用

        4. 統一的にダウンロードする必要がある場合は、`GET /v1/videos/{id}/content` を呼び出す


        主要パラメータ：

        - `model: string`：必須、外部向けモデル名

        - `prompt: string`：推奨、動画生成の説明

        - `seconds: number|string`：任意、目標の長さ

        - `duration: number|string`：任意、長さのエイリアス

        - `size: string`：任意、出力サイズ

        - `mode: string`：任意、一般的な値 `t2v` `i2v` `i2v_first_last`
        `reference_material`


        よく使われる互換パラメータ：

        - `aspect_ratio`

        - `ratio`

        - `quality`

        - `resolution`

        - `fps`

        - `image`

        - `image_url`

        - `image_urls`

        - `images`

        - `reference_images`

        - `input_reference`

        - `end_image_url`

        - `last_image_url`

        - `video_urls`

        - `audio_urls`

        - `function_mode`

        - `content`

        - `callback_url`

        - `external_task_id`


        Kling のよく使う拡張パラメータ：

        - `model_name`

        - `negative_prompt`

        - `cfg_scale`

        - `sound`

        - `camera_control`

        - `image_list`

        - `video_id`

        - `task_id`

        - `watermark_info`


        ### 4.1 Veo シリーズ


        説明：`stable`、`official` などは異なるグループを示しており、外部向けの `model`
        サフィックスではありません。呼び出し時は `model`
        をベースモデル名のままにしてください。実際にどのグループが使われるかは、アカウントまたはトークンのグループによって決まります。


        #### Veo 3.x メインモデル


        - `veo3`

        - `veo3-fast`

        - `veo3-fast-frames`

        - `veo3-frames`

        - `veo3-pro`

        - `veo3-pro-frames`

        - `veo3.1`

        - `veo3.1-fast`

        - `veo3.1-pro`

        - `veo3.1-components`

        - `veo3.1-4k`

        - `veo3.1-pro-4k`


        推奨:

        - テキストのみから動画を生成する場合は、`veo3*` / `veo3.1*` メインモデルを優先して使用

        - 画像からの動画生成や参照ベースの動画生成シーンでは、`mode + image_url/reference_images`
        を明示的に渡すことを推奨


        ### 4.2 Sora シリーズ


        基本モデル：

        - `sora-2`

        - `sora-2-pro`


        推奨:

        - `sora-2*` は汎用的な呼び出しに適しています

        - `stable` / `official` などのグループを使用する場合は、`model`
        をベースモデル名のままにし、モデル名の末尾にサフィックスを追加しないでください。


        リクエスト例:


        ```json

        {
          "size": "1280x720",
          "images": [
            "https://example.png"
          ],
          "model": "sora-2",
          "prompt": "this is an example",
          "duration": 12,
          "fps": "24",
          "seed": "20231024",
          "mode": "i2v"
        }

        ```


        ### 4.3 HappyHorse シリーズ


        公開モデル：

        - `happyhorse-1.0`


        推奨:

        - `happyhorse-1.0` は `mode` によって `t2v`、`i2v`、`r2v`、`video_edit` を区別します。

        - Sora 互換形式では、参考画像には `content` 配列でメディア項目を渡すことを推奨します。

        - テキスト項目には `type=text` を使用し、メディア項目には `type=image_url` を使用します。必要に応じて
        `role`、`name` と組み合わせて素材の用途を示せます。


        リクエスト例:


        ```json

        {
          "size": "720x1280",
          "model": "happyhorse-1.0",
          "mode": "r2v",
          "prompt": "this is an example",
          "duration": 15,
          "content": [
            {
              "type": "text",
              "text": "this is an example"
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.png"
              },
              "role": "reference_image",
              "name": "image1"
            }
          ],
          "parameters": {
            "resolution": "720P",
            "ratio": "9:16",
            "duration": 15,
            "seed": 1
          }
        }

        ```


        ### 4.4 Seedance シリーズ


        公開モデル：

        - `doubao-seedance-1-0-lite-t2v-250428`

        - `doubao-seedance-1-0-lite-i2v-250428`

        - `doubao-seedance-1-0-pro-250528`

        - `doubao-seedance-1-0-pro-fast-251015`

        - `doubao-seedance-1-5-pro-251215`

        - `doubao-seedance-2-0-260128`

        - `doubao-seedance-2-0-fast-260128`


        推奨:

        - テキストから動画を生成する場合は、`*-t2v-*` または `pro / fast` を優先してください

        - 画像から動画を生成する場合は、`*-i2v-*` を優先してください

        - 複雑な参考素材を用いるシナリオでは、`content` を優先して使用してください


        リクエスト例:


        ```json

        {
          "size": "1280x720",
          "model": "doubao-seedance-2-0-fast-260128",
          "prompt": "this is an example",
          "duration": 15,
          "fps": "24",
          "seed": "20231024",
          "mode": "reference_material",
          "content": [
            {
              "type": "text",
              "text": "this is an example"
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.png"
              },
              "role": "reference_image",
              "name": "image1"
            },
            {
              "type": "audio_url",
              "audio_url": {
                "url": "https://example.mp3"
              },
              "role": "reference_audio",
              "name": "audio1"
            }
          ]
        }

        ```


        ### 4.5 Grok ビデオシリーズ


        公開モデル：

        - `grok-imagine-1.0-video`

        - `grok-imagine-video-1.5-preview`

        - `grok-video-3`


        よく使うパラメータ：

        - `prompt`

        - `ratio` / `aspect_ratio`

        - `resolution` / `size`

        - `seconds` / `duration`

        - `image` / `image_url` / `input_reference`

        - `reference_images`


        例:


        ```json

        {
          "model": "grok-imagine-1.0-video",
          "prompt": "雨夜霓虹街道上的电影感推镜，光影丰富，运动自然",
          "reference_images": [
            "https://example.com/ref-1.jpg"
          ],
          "seconds": 10,
          "aspect_ratio": "16:9",
          "resolution": "720P"
        }

        ```


        ### 4.6 Kling ビデオメインモデル


        公開メインモデル：

        - `kling-video`


        必須：

        - `model`

        - `model_name`


        サポートされる `model_name`：

        - `kling-v1`

        - `kling-v1-5`

        - `kling-v1-6`

        - `kling-v2-master`

        - `kling-v2-1`

        - `kling-v2-1-master`

        - `kling-v2-5-turbo`

        - `kling-v2-6`

        - `kling-v3`


        一般的な `mode`:

        - `t2v`

        - `i2v`

        - `multi_i2v`

        - `extend`


        最小入力パラメータ：

        - テキストから動画: `model + model_name + prompt + mode=t2v`

        - 画像から動画: `model + model_name + prompt + mode=i2v + image`

        - 複数画像参照: `model + model_name + prompt + mode=multi_i2v + image_list`

        - 動画の延長: `model + model_name + mode=extend + video_id`


        例:


        ```json

        {
          "model": "kling-video",
          "model_name": "kling-v2-6",
          "mode": "t2v",
          "prompt": "海边日落镜头，电影感，风吹长发",
          "duration": 5,
          "aspect_ratio": "16:9"
        }

        ```


        ### 4.7 MiniMax / Hailuo 動画シリーズ


        公開モデル：

        - `minimax-h3`

        - `hailuo-2.3`


        推奨:

        - `minimax-h3` はテキストから動画生成、画像参照、音声参照をサポートします。`content`
        でテキストと素材を混在させることを推奨します。`image_urls`、`audio_urls` などの互換フィールドも使用できます。

        - `hailuo-2.3` では最初のフレーム画像が必要です。`content` で `role=first_frame` の
        `image_url` 項目を渡すか、`image_urls` を使用して最初のフレーム画像を渡すことを推奨します。

        - `minimax-h3` でよく使うのは `duration=5~15`、`resolution=1440p`
        です。`hailuo-2.3` でよく使うのは `duration=6` または `10`、`resolution=768p` です。


        `minimax-h3` の例：


        ```json

        {
          "model": "minimax-h3",
          "prompt": "A cinematic product video with smooth camera motion",
          "content": [
            {
              "type": "text",
              "text": "Use the product image as reference and match the rhythm of the audio."
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.com/product.jpg"
              },
              "role": "reference_image",
              "name": "product"
            },
            {
              "type": "audio_url",
              "audio_url": {
                "url": "https://example.com/music.mp3"
              },
              "role": "reference_audio",
              "name": "music"
            }
          ],
          "duration": 8,
          "resolution": "1440p",
          "aspect_ratio": "16:9",
          "generate_audio": true
        }

        ```


        `hailuo-2.3` の例：


        ```json

        {
          "model": "hailuo-2.3",
          "prompt": "The camera slowly pushes in, natural motion and cinematic lighting.",
          "content": [
            {
              "type": "text",
              "text": "The camera slowly pushes in, natural motion and cinematic lighting."
            },
            {
              "type": "image_url",
              "image_url": {
                "url": "https://example.com/first-frame.jpg"
              },
              "role": "first_frame",
              "name": "first"
            }
          ],
          "duration": 10,
          "resolution": "768p",
          "aspect_ratio": "16:9"
        }

        ```


        - `mode=t2v`

        - 最小入力パラメータ：`model + prompt`


        - `mode=i2v`

        - 最小入力パラメータ：`model + prompt + image_url`


        - `mode=i2v_first_last`

        - 最小入力パラメータ：`model + prompt + image_url + end_image_url`


        - `mode=reference_images`

        - 最小入力パラメータ：`model + prompt + reference_images`


        - `mode=reference_material`

        - 最小入力パラメータ：`model + prompt + (image_urls/video_urls/audio_urls 至少一种)`


        ### Gemini Omni の呼び出し方法


        - `gemini-omni` は new-api の外部公開動画モデル名で、`POST /v1/videos` を直接利用できます。

        - `mode=t2v`：テキストから動画を生成します。最小入力パラメータは `model + prompt` です。

        - `mode=r2v`：参照画像/参照素材による生成。画像は
        `image`、`image_url`、`images`、`image_urls`、`reference_images`、`input_reference`、または
        `content` に設定できます。

        - `mode=edit`：動画編集。動画は `video`、`video_url`、`videos`、または `content`
        に設定でき、参照画像も同時に送信できます。

        - 再生時間フィールドは `seconds` または `duration` を使用でき、4 / 6 / 8 / 10
        秒のいずれかに自動でマッチします。
      operationId: createVideo
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  description: 必須。外部公開モデル名。`gemini-omni` は `/v1/videos` から呼び出せます。
                  enum:
                    - sora-2
                    - sora-2-pro
                    - gemini-omni
                    - happyhorse-1.0
                    - happyhorse-1.0-i2v
                    - happyhorse-1.0-t2v
                    - happyhorse-1.0-r2v
                    - happyhorse-1.0-video-edit
                    - doubao-seedance-1-0-lite-i2v-250428
                    - doubao-seedance-1-0-lite-t2v-250428
                    - doubao-seedance-1-0-pro-250528
                    - doubao-seedance-1-0-pro-fast-251015
                    - doubao-seedance-1-5-pro-251215
                    - doubao-seedance-2-0-260128
                    - doubao-seedance-2-0-fast-260128
                    - veo3
                    - veo3-fast
                    - veo3-fast-frames
                    - veo3-frames
                    - veo3-pro
                    - veo3-pro-frames
                    - veo3.1
                    - veo3.1-4k
                    - veo3.1-components
                    - veo3.1-fast
                    - veo3.1-pro
                    - veo3.1-pro-4k
                    - kling-video
                    - grok-imagine-1.0-video
                    - grok-imagine-video-1.5-preview
                    - grok-video-3
                    - minimax-h3
                    - hailuo-2.3
                    - viduq3-turbo
                  example: sora-2
                prompt:
                  type: string
                  description: 共通プロンプトの入力欄。ほとんどのモデルで必須です。
                image:
                  type: string
                  format: binary
                  description: 単一画像エントリ。一部の互換モードでは images にマッピングされます。
                duration:
                  type: integer
                  description: duration の統一された入力パラメータです。一部のモデルでは seconds も受け付けます。
                width:
                  type: integer
                  example: 512
                  description: Video width
                height:
                  type: integer
                  example: 512
                  description: Video height
                fps:
                  type: integer
                  example: 30
                  description: Video frame rate
                seed:
                  type: integer
                  example: 20231234
                  description: Random seed
                'n':
                  type: integer
                  example: 1
                  description: Number of videos to generate
                response_format:
                  type: string
                  example: url
                  description: Response format
                user:
                  type: string
                  example: user-1234
                  description: User identifier
                metadata:
                  type: object
                  additionalProperties: true
                  description: 動的拡張フィールドコンテナです。モデル固有の大量のフィールドがここからデシリアライズされます。
                mode:
                  type: string
                  description: 任意、動画生成モード。 `gemini-omni` は `t2v`、`r2v`、`edit` をサポートします。
                images:
                  type: array
                  description: 複数画像の統一エントリ。Vidu、Seedance、Veo などで使用されます。
                  items:
                    type: string
                content:
                  type: array
                  items:
                    type: object
                    additionalProperties: true
                size:
                  type: string
                  description: サイズの統一入力口で、resolution/aspect_ratio などにマッピングされます。
                seconds:
                  type: string
                  description: Sora の互換エントリ。実行時には duration にフォールバックします。
                input_reference:
                  type: string
                  description: Sora/Veo 互換の参照画像エントリ。multipartファイルまたは互換オブジェクトを指定できます。
                parameters:
                  type: object
                  additionalProperties: true
              required:
                - model
                - prompt
            examples:
              openai_i2v_json:
                summary: OpenAI Sora i2v (application/json)
                value:
                  size: 1280x720
                  images:
                    - https://example.png
                  model: sora-2
                  prompt: this is an example
                  duration: 12
                  fps: '24'
                  seed: '20231024'
                  mode: i2v
              openai_i2v_input_reference:
                summary: OpenAI i2v (input_reference)
                value:
                  model: sora-2
                  prompt: A cinematic drone shot over snowy mountains at sunrise
                  input_reference:
                    image_url: https://example.com/input.jpg
                  seconds: '8'
                  size: 1280x720
                  response_format: url
              openai_alias_compat:
                summary: Alias兼容 (image_url/duration/aspect_ratio)
                value:
                  model: sora-2
                  prompt: A cinematic drone shot over snowy mountains at sunrise
                  image_url: https://example.com/input.jpg
                  duration: '8'
                  aspect_ratio: '16:9'
                  response_format: url
              gemini_omni_sora_t2v:
                summary: Gemini Omni Sora t2v
                value:
                  model: gemini-omni
                  mode: t2v
                  prompt: A cinematic product video with smooth camera motion
                  duration: 8
                  size: 1280x720
              gemini_omni_sora_r2v:
                summary: Gemini Omni Sora r2v
                value:
                  model: gemini-omni
                  mode: r2v
                  content:
                    - type: text
                      text: Keep the product consistent and create a short ad video
                    - type: image_url
                      image_url:
                        url: https://example.com/product.jpg
                  duration: 8
                  size: 1280x720
              gemini_omni_sora_edit:
                summary: Gemini Omni Sora edit
                value:
                  model: gemini-omni
                  mode: edit
                  content:
                    - type: text
                      text: Change the outfit color while keeping the motion natural
                    - type: video_url
                      video_url:
                        url: https://example.com/input.mp4
                    - type: image_url
                      image_url:
                        url: https://example.com/style.jpg
                  duration: 8
                  size: 1280x720
              happyhorse_sora_t2v:
                summary: HappyHorse Sora t2v
                value:
                  model: happyhorse-1.0
                  mode: t2v
                  content:
                    - type: text
                      text: >-
                        A cinematic white horse running through a neon city
                        street
                  duration: 5
                  resolution: 720P
                  ratio: '16:9'
              happyhorse_sora_i2v:
                summary: HappyHorse Sora i2v
                value:
                  model: happyhorse-1.0
                  mode: i2v
                  content:
                    - type: text
                      text: The camera slowly pushes in, natural motion
                    - type: image_url
                      image_url: https://example.com/first-frame.jpg
                  duration: 5
                  resolution: 720P
              happyhorse_sora_r2v:
                summary: HappyHorse Sora r2v
                value:
                  size: 720x1280
                  model: happyhorse-1.0
                  mode: r2v
                  prompt: this is an example
                  duration: 15
                  content:
                    - type: text
                      text: this is an example
                    - type: image_url
                      image_url:
                        url: https://example.png
                      role: reference_image
                      name: image1
                  parameters:
                    resolution: 720P
                    ratio: '9:16'
                    duration: 15
                    seed: 1
              happyhorse_sora_video_edit:
                summary: HappyHorse Sora video_edit
                value:
                  model: happyhorse-1.0
                  mode: video_edit
                  content:
                    - type: text
                      text: >-
                        Change the jacket to a striped sweater and keep the
                        motion natural
                    - type: video_url
                      video_url: https://example.com/input.mp4
                    - type: image_url
                      image_url: https://example.com/reference.jpg
                  resolution: 720P
              seedance_i2v_first:
                summary: Seedance i2v_first
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: i2v_first
                  prompt: A panda skateboarding in a city street, cinematic
                  image_urls:
                    - https://example.com/first.jpg
                  seconds: '5'
                  size: 1280x720
              seedance_i2v_first_last:
                summary: Seedance i2v_first_last
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: i2v_first_last
                  prompt: A camera moves from first frame to last frame naturally
                  image_urls:
                    - https://example.com/first.jpg
                  end_image_url: https://example.com/last.jpg
                  seconds: '5'
                  size: 1280x720
              seedance_reference_images:
                summary: Seedance reference_images
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: reference_images
                  prompt: Stylized short video keeping character consistency
                  reference_images:
                    - https://example.com/ref-1.jpg
                    - https://example.com/ref-2.jpg
                  seconds: '5'
                  size: 1280x720
              seedance_reference_material:
                summary: Seedance オールインワン参考モード(reference_material)
                value:
                  model: doubao-seedance-1-0-lite-i2v-250428
                  mode: reference_material
                  prompt: >-
                    Blend image and short reference video into a coherent
                    cinematic clip
                  reference_images:
                    - https://example.com/ref-1.jpg
                    - https://example.com/ref-2.jpg
                  video_urls:
                    - https://example.com/ref-video.mp4
                  audio_urls:
                    - https://example.com/ref-audio.mp3
                  seconds: '5'
                  size: 1280x720
              seedance_volc_content:
                summary: Seedance Volcano Ark content モード
                value:
                  size: 1280x720
                  model: doubao-seedance-2-0-fast-260128
                  prompt: this is an example
                  duration: 15
                  fps: '24'
                  seed: '20231024'
                  mode: reference_material
                  content:
                    - type: text
                      text: this is an example
                    - type: image_url
                      image_url:
                        url: https://example.png
                      role: reference_image
                      name: image1
                    - type: audio_url
                      audio_url:
                        url: https://example.mp3
                      role: reference_audio
                      name: audio1
              veo_first_last_frame:
                summary: Veo 先頭・末尾フレームモード
                value:
                  model: veo3.1-fast
                  prompt: >-
                    A smooth transition from first frame to last frame,
                    cinematic motion
                  image_urls:
                    - https://example.com/first-frame.jpg
                  end_image_url: https://example.com/last-frame.jpg
                  seconds: '8'
                  size: 1280x720
              veo_reference_images_1to3:
                summary: Veo 1～3枚の参考画像モード
                value:
                  model: veo3.1-fast
                  prompt: >-
                    Use reference style and character consistency for a short ad
                    clip
                  reference_images:
                    - https://example.com/ref-1.jpg
                  seconds: '8'
                  size: 1280x720
              kling_text2video:
                summary: Kling テキストから動画を生成
                value:
                  model: kling-video
                  prompt: A cat playing piano in the garden
                  duration: 5
                  size: 1280x720
                  metadata:
                    negative_prompt: blurry, low quality
                    mode: std
              kling_image2video:
                summary: Kling イメージから動画生成
                value:
                  model: kling-video
                  prompt: A cat playing piano in the garden
                  image: https://example.com/input.jpg
                  duration: 5
                  size: 1280x720
                  metadata:
                    negative_prompt: blurry, low quality
                    mode: std
              grok_reference_video:
                summary: Grok ビデオモード
                value:
                  model: grok-imagine-1.0-video
                  prompt: A dramatic cinematic shot with fast motion and rich lighting
                  reference_images:
                    - https://example.com/ref-1.jpg
                  seconds: 10
                  aspect_ratio: '16:9'
                  resolution: 720P
              minimax_h3_sora_reference:
                summary: MiniMax H3 マルチ素材動画
                value:
                  model: minimax-h3
                  prompt: A cinematic product video with smooth camera motion
                  content:
                    - type: text
                      text: >-
                        Use the product image as reference and match the rhythm
                        of the audio.
                    - type: image_url
                      image_url:
                        url: https://example.com/product.jpg
                      role: reference_image
                      name: product
                    - type: audio_url
                      audio_url:
                        url: https://example.com/music.mp3
                      role: reference_audio
                      name: music
                  duration: 8
                  resolution: 1440p
                  aspect_ratio: '16:9'
                  generate_audio: true
              hailuo_2_3_sora_first_frame:
                summary: Hailuo 2.3 最初のフレーム画像から動画を生成
                value:
                  model: hailuo-2.3
                  prompt: >-
                    The camera slowly pushes in, natural motion and cinematic
                    lighting.
                  content:
                    - type: text
                      text: >-
                        The camera slowly pushes in, natural motion and
                        cinematic lighting.
                    - type: image_url
                      image_url:
                        url: https://example.com/first-frame.jpg
                      role: first_frame
                      name: first
                  duration: 10
                  resolution: 768p
                  aspect_ratio: '16:9'
              vidu_sora_t2v:
                summary: Vidu Sora t2v
                value:
                  model: viduq3-turbo
                  mode: t2v
                  content:
                    - type: text
                      text: A stylish product ad clip with cinematic lighting
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
              vidu_sora_i2v:
                summary: Vidu Sora i2v
                value:
                  model: viduq3-turbo
                  mode: i2v
                  content:
                    - type: text
                      text: A stylish ad clip from a product still image
                    - type: image_url
                      image_url: https://example.com/product.jpg
                  duration: 5
                  resolution: 720p
              vidu_sora_first_last:
                summary: Vidu Sora i2v_first_last
                value:
                  model: viduq3-turbo
                  mode: i2v_first_last
                  content:
                    - type: text
                      text: A smooth shot from start frame to end frame
                    - type: image_url
                      image_url: https://example.com/start.jpg
                    - type: image_url
                      image_url: https://example.com/end.jpg
                  duration: 5
                  resolution: 720p
              vidu_sora_reference:
                summary: Vidu Sora reference_images
                value:
                  model: viduq3-turbo
                  mode: reference_images
                  content:
                    - type: text
                      text: Maintain product style and character consistency
                    - type: image_url
                      image_url: https://example.com/ref-1.jpg
                    - type: image_url
                      image_url: https://example.com/ref-2.jpg
                    - type: image_url
                      image_url: https://example.com/ref-3.jpg
                  duration: 5
                  resolution: 720p
                  aspect_ratio: '16:9'
              hailuo_text2video:
                summary: Hailuo 2.3 最初のフレーム画像から動画を生成
                value:
                  model: hailuo-2.3
                  prompt: A cinematic travel shot over the coastline
                  image_urls:
                    - https://example.com/first-frame.jpg
                  duration: 6
                  resolution: 768p
                  aspect_ratio: '16:9'
      responses:
        '200':
          description: 動画タスクの作成に成功しました
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  task_id:
                    type: string
                    description: レガシーAPI互換（非推奨予定）
                  object:
                    type: string
                  model:
                    type: string
                  status:
                    type: string
                    description: >-
                      Should use VideoStatus constants: VideoStatusQueued,
                      VideoStatusInProgress, VideoStatusCompleted,
                      VideoStatusFailed
                    enum:
                      - queued
                      - in_progress
                      - completed
                      - failed
                      - video_url
                      - url
                      - completed_at
                  progress:
                    type: integer
                  created_at:
                    type: integer
                  completed_at:
                    type: integer
                  expires_at:
                    type: integer
                  seconds:
                    type: string
                  size:
                    type: string
                  remixed_from_video_id:
                    type: string
                  error:
                    type: object
                  metadata:
                    type: object
                    additionalProperties: true
                  output:
                    type: object
                  request_id:
                    type: string
                required:
                  - created_at
                  - id
                  - model
                  - object
                  - progress
                  - status
              example:
                id: video_abc123
                object: video
                model: sora-2
                status: queued
                progress: 0
                created_at: 1764347090922
                seconds: '8'
          headers: {}
        '400':
          description: リクエストパラメータのエラー
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: エラーメッセージ
            type:
              type: string
              description: エラータイプ
            param:
              type: string
              description: 関連パラメータ
              nullable: true
            code:
              type: string
              description: エラーコード
              nullable: true
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Bearer Token を使用して認証します。
        形式: `Authorization: Bearer sk-xxxxxx`

````