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

# 動画を作成する(HappyHorseとWan)

> このシリーズはOpenAIの動画生成形式をサポートしています（詳細はリンク [動画生成Sora互換形式](/api-reference/ja/video-generation-sora-compatible-format/create-video) を参照してください）。

HappyHorse と Wan の動画生成インターフェースは、公開パスが DashScope の公式プロトコルに準拠します。

HappyHorse は `happyhorse-1.0`、`happyhorse-1.0-i2v`、`happyhorse-1.0-t2v`、`happyhorse-1.0-r2v`、`happyhorse-1.0-video-edit` をサポートします。Wan は `wan-3.0`、`wan-3.0-480p`、`wan-3.0-1080p` をサポートします。うち `happyhorse-1.0` は集約モデルで、`mode` によって `t2v`、`i2v`、`r2v`、`video_edit` を区別する必要があります。Wan の 3 つのモデルはそれぞれ 720P、480P、1080P に固定され、2～30 秒および最大 10 枚の画像、5 本の動画、5 つの音声参照をサポートします。

公開APIは公式エンドポイント形式を維持します。チャネル専用プレフィックスは、ゲートウェイが特定の上流チャネルにリクエストする際の内部連結にのみ使用します。クライアントが `X-DashScope-Async` を明示的に渡す必要はなく、ゲートウェイまたは公式チャネル適配層が処理します。

HappyHorse と Wan の動画生成形式について、公開リクエストの骨組み、タスク照会構造、推奨検証テンプレートを補足します。公開パスは DashScope の公式エンドポイント形式を維持します。

対応モデル：
happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p

共通リクエストフィールド：
- `model` (string, 必須): HappyHorse または Wan の外部公開モデル名。Wan は `wan-3.0`、`wan-3.0-480p`、`wan-3.0-1080p` をサポートします。HappyHorse の集約モデル `happyhorse-1.0` は `mode` と併用する必要があります。
- `mode` (string, 任意): 集約モデルのモード。一般的な値は `t2v`、`i2v`、`r2v`、`video_edit` です。固定サブモデルの場合は省略できます。
- `input.prompt` (string, 必須): 動画生成または編集のプロンプト。
- `input.media` (array[object], 任意): マルチメディア入力。`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` をサポートします。Wan は最大 10 枚の画像、5 本の動画、5 つの音声をサポートします。
- `parameters.duration` (integer, 任意): 生成時間（秒単位）。
- `parameters.resolution` (string, 任意): 出力解像度。Wan の 3 つのモデルはそれぞれ `720P`、`480P`、`1080P` に固定されています。HappyHorse の一般的な値は `720P`、`1080P` です。
- `parameters.ratio` (string, 任意): 出力アスペクト比。テキストから動画、参照から動画でよく使用されます。
- `parameters.watermark` (boolean, 任意): ウォーターマークを追加するかどうか。
- `parameters.seed` (integer, 任意): 乱数シード。

代表的なモデル/モードの違い：
- `HappyHorse 聚合模型`: 対応モデルは happyhorse-1.0。集約モデルは mode で最終モデルを区別します。
- `HappyHorse 文生视频`: 対応モデルは happyhorse-1.0-t2v。公式フォーマットのテキストから動画です。
- `HappyHorse 首帧图生视频`: 対応モデルは happyhorse-1.0-i2v。公式フォーマットの先頭フレーム画像から動画です。
- `HappyHorse 参考生视频`: 対応モデルは happyhorse-1.0-r2v。公式フォーマットの複数参照画像から動画です。
- `HappyHorse 视频编辑`: 対応モデルは happyhorse-1.0-video-edit。公式フォーマットの動画編集です。
- `Wan 3.0 720P`: サポートモデル wan-3.0。Wan 3.0 公式形式のマルチモーダル参照動画生成。
- `Wan 3.0 480P`: サポートモデル wan-3.0-480p。480P 固定の Wan 3.0 公式形式呼び出し。
- `Wan 3.0 1080P`: サポートモデル wan-3.0-1080p。1080P 固定の Wan 3.0 公式形式呼び出し。



## OpenAPI

````yaml api-reference/ja/openapi.json POST /api/v1/services/aigc/video-generation/video-synthesis
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:
  /api/v1/services/aigc/video-generation/video-synthesis:
    post:
      tags:
        - 動画生成HappyHorseとWan
      summary: 動画を作成する(HappyHorseとWan)
      description: >-
        このシリーズはOpenAIの動画生成形式をサポートしています（詳細はリンク
        [動画生成Sora互換形式](/api-reference/ja/video-generation-sora-compatible-format/create-video)
        を参照してください）。


        HappyHorse と Wan の動画生成インターフェースは、公開パスが DashScope の公式プロトコルに準拠します。


        HappyHorse は
        `happyhorse-1.0`、`happyhorse-1.0-i2v`、`happyhorse-1.0-t2v`、`happyhorse-1.0-r2v`、`happyhorse-1.0-video-edit`
        をサポートします。Wan は `wan-3.0`、`wan-3.0-480p`、`wan-3.0-1080p` をサポートします。うち
        `happyhorse-1.0` は集約モデルで、`mode` によって `t2v`、`i2v`、`r2v`、`video_edit`
        を区別する必要があります。Wan の 3 つのモデルはそれぞれ 720P、480P、1080P に固定され、2～30 秒および最大 10
        枚の画像、5 本の動画、5 つの音声参照をサポートします。


        公開APIは公式エンドポイント形式を維持します。チャネル専用プレフィックスは、ゲートウェイが特定の上流チャネルにリクエストする際の内部連結にのみ使用します。クライアントが
        `X-DashScope-Async` を明示的に渡す必要はなく、ゲートウェイまたは公式チャネル適配層が処理します。


        HappyHorse と Wan の動画生成形式について、公開リクエストの骨組み、タスク照会構造、推奨検証テンプレートを補足します。公開パスは
        DashScope の公式エンドポイント形式を維持します。


        対応モデル：

        happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v,
        happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p,
        wan-3.0-1080p


        共通リクエストフィールド：

        - `model` (string, 必須): HappyHorse または Wan の外部公開モデル名。Wan は
        `wan-3.0`、`wan-3.0-480p`、`wan-3.0-1080p` をサポートします。HappyHorse の集約モデル
        `happyhorse-1.0` は `mode` と併用する必要があります。

        - `mode` (string, 任意): 集約モデルのモード。一般的な値は `t2v`、`i2v`、`r2v`、`video_edit`
        です。固定サブモデルの場合は省略できます。

        - `input.prompt` (string, 必須): 動画生成または編集のプロンプト。

        - `input.media` (array[object], 任意):
        マルチメディア入力。`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio`
        をサポートします。Wan は最大 10 枚の画像、5 本の動画、5 つの音声をサポートします。

        - `parameters.duration` (integer, 任意): 生成時間（秒単位）。

        - `parameters.resolution` (string, 任意): 出力解像度。Wan の 3 つのモデルはそれぞれ
        `720P`、`480P`、`1080P` に固定されています。HappyHorse の一般的な値は `720P`、`1080P` です。

        - `parameters.ratio` (string, 任意): 出力アスペクト比。テキストから動画、参照から動画でよく使用されます。

        - `parameters.watermark` (boolean, 任意): ウォーターマークを追加するかどうか。

        - `parameters.seed` (integer, 任意): 乱数シード。


        代表的なモデル/モードの違い：

        - `HappyHorse 聚合模型`: 対応モデルは happyhorse-1.0。集約モデルは mode で最終モデルを区別します。

        - `HappyHorse 文生视频`: 対応モデルは happyhorse-1.0-t2v。公式フォーマットのテキストから動画です。

        - `HappyHorse 首帧图生视频`: 対応モデルは
        happyhorse-1.0-i2v。公式フォーマットの先頭フレーム画像から動画です。

        - `HappyHorse 参考生视频`: 対応モデルは happyhorse-1.0-r2v。公式フォーマットの複数参照画像から動画です。

        - `HappyHorse 视频编辑`: 対応モデルは happyhorse-1.0-video-edit。公式フォーマットの動画編集です。

        - `Wan 3.0 720P`: サポートモデル wan-3.0。Wan 3.0 公式形式のマルチモーダル参照動画生成。

        - `Wan 3.0 480P`: サポートモデル wan-3.0-480p。480P 固定の Wan 3.0 公式形式呼び出し。

        - `Wan 3.0 1080P`: サポートモデル wan-3.0-1080p。1080P 固定の Wan 3.0 公式形式呼び出し。
      operationId: create__happyhorse_wan_task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - input
              properties:
                model:
                  type: string
                  enum:
                    - happyhorse-1.0
                    - happyhorse-1.0-t2v
                    - happyhorse-1.0-i2v
                    - happyhorse-1.0-r2v
                    - happyhorse-1.0-video-edit
                    - wan-3.0
                    - wan-3.0-480p
                    - wan-3.0-1080p
                  example: happyhorse-1.0-t2v
                  description: >-
                    HappyHorse または Wan の外部公開モデル名。Wan は
                    `wan-3.0`、`wan-3.0-480p`、`wan-3.0-1080p` をサポートします。HappyHorse
                    の集約モデル `happyhorse-1.0` は `mode` と併用する必要があります。
                mode:
                  type: string
                  enum:
                    - t2v
                    - i2v
                    - r2v
                    - video_edit
                  description: >-
                    アグリゲーションモデルのモード。一般的な値は `t2v`、`i2v`、`r2v`、`video_edit`
                    です。固定サブモデルは指定しなくてもかまいません。
                input:
                  type: object
                  required:
                    - prompt
                  properties:
                    prompt:
                      type: string
                      example: >-
                        A white horse running through a neon city street,
                        cinematic
                      description: 動画生成または編集のプロンプト。
                    media:
                      type: array
                      items:
                        type: object
                        required:
                          - type
                          - url
                        properties:
                          type:
                            type: string
                            enum:
                              - first_frame
                              - last_frame
                              - reference_image
                              - reference_video
                              - reference_audio
                              - video
                              - audio
                          url:
                            type: string
                            format: uri
                      description: >-
                        マルチメディア入力。`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio`
                        をサポートします。Wan は最大で画像 10 枚、動画 5 本、音声 5 件をサポートします。
                parameters:
                  type: object
                  properties:
                    resolution:
                      type: string
                      enum:
                        - 480P
                        - 720P
                        - 1080P
                      example: 720P
                      description: >-
                        出力解像度。Wan の3つのモデルはそれぞれ `720P`、`480P`、`1080P`
                        に固定されています。HappyHorse の一般的な値は `720P`、`1080P` です。
                    ratio:
                      type: string
                      example: '16:9'
                      description: 出力のアスペクト比。テキストから動画と参照動画の生成でよく使用されます。
                    duration:
                      type: integer
                      example: 5
                      description: 生成時間（秒）。
                    watermark:
                      type: boolean
                      description: 透かしを追加するかどうか。
                    seed:
                      type: integer
                      description: 乱数シード。
            examples:
              happyhorse_native_aggregate_t2v:
                summary: HappyHorse 集約モデル
                value:
                  model: happyhorse-1.0
                  mode: t2v
                  input:
                    prompt: >-
                      A white horse running through a neon city street,
                      cinematic
                  parameters:
                    resolution: 720P
                    ratio: '16:9'
                    duration: 5
              happyhorse_native_t2v:
                summary: HappyHorse テキストから動画
                value:
                  model: happyhorse-1.0-t2v
                  input:
                    prompt: >-
                      A white horse running through a neon city street,
                      cinematic
                  parameters:
                    resolution: 720P
                    ratio: '16:9'
                    duration: 5
              happyhorse_native_i2v:
                summary: HappyHorse 最初のフレーム画像から動画生成
                value:
                  model: happyhorse-1.0-i2v
                  input:
                    prompt: The subject walks forward naturally
                    media:
                      - type: first_frame
                        url: https://example.com/first-frame.jpg
                  parameters:
                    resolution: 720P
                    duration: 5
              happyhorse_native_r2v:
                summary: HappyHorse 参考動画
                value:
                  model: happyhorse-1.0-r2v
                  input:
                    prompt: >-
                      Keep the character and product consistent in a cinematic
                      shot
                    media:
                      - type: reference_image
                        url: https://example.com/ref-1.jpg
                      - type: reference_image
                        url: https://example.com/ref-2.jpg
                  parameters:
                    resolution: 720P
                    ratio: '16:9'
                    duration: 5
              happyhorse_native_video_edit:
                summary: HappyHorse 動画編集
                value:
                  model: happyhorse-1.0-video-edit
                  input:
                    prompt: Change the jacket to a striped sweater
                    media:
                      - type: video
                        url: https://example.com/input.mp4
                      - type: reference_image
                        url: https://example.com/reference.jpg
                  parameters:
                    resolution: 720P
              wan_3_0_native:
                summary: Wan 3.0 720P
                value:
                  model: wan-3.0
                  input:
                    prompt: Keep the character consistent across all references
                    media:
                      - type: reference_image
                        url: https://example.com/reference.jpg
                      - type: reference_audio
                        url: https://example.com/reference.mp3
                  parameters:
                    resolution: 720P
                    ratio: '16:9'
                    duration: 10
              wan_3_0_480p_native:
                summary: Wan 3.0 480P
                value:
                  model: wan-3.0-480p
                  input:
                    prompt: Create a smooth transition
                    media:
                      - type: first_frame
                        url: https://example.com/first.jpg
                      - type: last_frame
                        url: https://example.com/last.jpg
                  parameters:
                    resolution: 480P
                    ratio: '16:9'
                    duration: 10
              wan_3_0_1080p_native:
                summary: Wan 3.0 1080P
                value:
                  model: wan-3.0-1080p
                  input:
                    prompt: Generate a cinematic reference video
                    media:
                      - type: reference_video
                        url: https://example.com/reference.mp4
                  parameters:
                    resolution: 1080P
                    ratio: '16:9'
                    duration: 10
      responses:
        '200':
          description: タスクの作成に成功しました
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                properties:
                  id:
                    type: string
                    example: task_xxx
                  output:
                    type: object
                    properties:
                      task_id:
                        type: string
                        description: タスク作成時に返されるタスク ID。タスクの照会に使用します。
                      task_status:
                        type: string
                        description: >-
                          タスクの状態。一般的な値は `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`
                          です。
                      video_url:
                        type: string
                        description: タスク成功後に生成される動画の URL。
                  usage:
                    type: object
                    properties:
                      duration:
                        type: string
                        description: 生成時間（秒）。
                      SR:
                        type: string
                        description: 出力解像度のレベル。
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Bearer Token を使用して認証します。
        形式: `Authorization: Bearer sk-xxxxxx`

````