> ## 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 GET /api/v1/tasks/{task_id}
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/tasks/{task_id}:
    get:
      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: query__happyhorse_wan_task
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: タスク ID。タスク作成の応答で返される `id` から取得します。
      responses:
        '200':
          description: 照会に成功しました
          content:
            application/json:
              schema:
                type: object
                properties:
                  output:
                    type: object
                    properties:
                      task_id:
                        type: string
                        description: タスク作成時に返されるタスク ID。タスクの照会に使用します。
                      task_status:
                        type: string
                        enum:
                          - PENDING
                          - RUNNING
                          - SUCCEEDED
                          - FAILED
                          - UNKNOWN
                        description: >-
                          タスクの状態。一般的な値は `PENDING`、`RUNNING`、`SUCCEEDED`、`FAILED`
                          です。
                      submit_time:
                        type: string
                      scheduled_time:
                        type: string
                      end_time:
                        type: string
                      video_url:
                        type: string
                        format: uri
                        description: タスク成功後に生成される動画の URL。
                      code:
                        type: string
                      message:
                        type: string
                  usage:
                    type: object
                    properties:
                      duration:
                        type: integer
                        description: 生成時間（秒）。
                      SR:
                        type: integer
                        description: 出力解像度のレベル。
                      video_count:
                        type: integer
                  request_id:
                    type: string
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Bearer Token を使用して認証します。
        形式: `Authorization: Bearer sk-xxxxxx`

````