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

# Query task(HappyHorse and Wan)

> This series supports OpenAI video generation formats (see the link [Video generation Sora compatible formats](/api-reference/en/video-generation-sora-compatible-format/create-video)).

HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol.

HappyHorse supports `happyhorse-1.0`, `happyhorse-1.0-i2v`, `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, and `happyhorse-1.0-video-edit`; Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`. Among them, `happyhorse-1.0` is an aggregated model and must be distinguished via `mode` into `t2v`, `i2v`, `r2v`, and `video_edit`. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references.

The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass `X-DashScope-Async` explicitly; it is handled by the gateway or the official channel adapter layer.

Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format.

Supported models:
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

Unified request fields:
- `model` (string, required): The external model name for HappyHorse or Wan. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used together with `mode`.
- `mode` (string, optional): Aggregated model mode; common values are `t2v`, `i2v`, `r2v`, and `video_edit`. You can omit this for fixed submodels.
- `input.prompt` (string, required): Prompt for video generation or editing.
- `input.media` (array[object], optional): Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files.
- `parameters.duration` (integer, optional): Generation duration, in seconds.
- `parameters.resolution` (string, optional): Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; common values for HappyHorse are `720P` and `1080P`.
- `parameters.ratio` (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video.
- `parameters.watermark` (boolean, optional): Whether to add a watermark.
- `parameters.seed` (integer, optional): Random seed.

Common model/mode differences:
- `HappyHorse 聚合模型`: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model.
- `HappyHorse 文生视频`: Supports model happyhorse-1.0-t2v; official-format text-to-video.
- `HappyHorse 首帧图生视频`: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video.
- `HappyHorse 参考生视频`: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video.
- `HappyHorse 视频编辑`: Supports model happyhorse-1.0-video-edit; official-format video editing.
- `Wan 3.0 720P`: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation.
- `Wan 3.0 480P`: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P.
- `Wan 3.0 1080P`: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.



## OpenAPI

````yaml api-reference/en/openapi.json GET /api/v1/tasks/{task_id}
openapi: 3.0.0
info:
  title: Overseas Expansion Camp API Reference Documentation
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: OpenAI format (Chat)
  - name: OpenAI Format (Responses)
  - name: Gemini Format for Image Generation
  - name: Image generationOpenAI DALL-E format
  - name: List models
  - name: Video generationHappyHorse and Wan
  - name: Video generation Kling format
  - name: Video generation Omni and Veo formats
  - name: Video generation Seedance
  - name: Video generation Sora compatible formats
  - name: Video generation Vidu
  - name: Music generation task format
paths:
  /api/v1/tasks/{task_id}:
    get:
      tags:
        - Video generationHappyHorse and Wan
      summary: Query task(HappyHorse and Wan)
      description: >-
        This series supports OpenAI video generation formats (see the link
        [Video generation Sora compatible
        formats](/api-reference/en/video-generation-sora-compatible-format/create-video)).


        HappyHorse and the Wan video generation API, with public paths following
        the official DashScope protocol.


        HappyHorse supports `happyhorse-1.0`, `happyhorse-1.0-i2v`,
        `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, and
        `happyhorse-1.0-video-edit`; Wan supports `wan-3.0`, `wan-3.0-480p`, and
        `wan-3.0-1080p`. Among them, `happyhorse-1.0` is an aggregated model and
        must be distinguished via `mode` into `t2v`, `i2v`, `r2v`, and
        `video_edit`. The three Wan models are fixed at 720P, 480P, and 1080P
        respectively, and support 2 to 30 seconds plus up to 10 image, 5 video,
        and 5 audio references.


        The public API keeps the official endpoint format; channel-specific
        prefixes are only concatenated internally when the gateway requests a
        specific upstream channel. Clients do not need to pass
        `X-DashScope-Async` explicitly; it is handled by the gateway or the
        official channel adapter layer.


        Provides the public request skeleton, task query structure, and
        recommended validation template for HappyHorse and Wan video generation
        formats; public paths follow the official DashScope endpoint format.


        Supported models:

        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


        Unified request fields:

        - `model` (string, required): The external model name for HappyHorse or
        Wan. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the
        HappyHorse aggregated model `happyhorse-1.0` must be used together with
        `mode`.

        - `mode` (string, optional): Aggregated model mode; common values are
        `t2v`, `i2v`, `r2v`, and `video_edit`. You can omit this for fixed
        submodels.

        - `input.prompt` (string, required): Prompt for video generation or
        editing.

        - `input.media` (array[object], optional): Multimedia input. Supports
        `first_frame`, `last_frame`, `reference_image`, `reference_video`, and
        `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio
        files.

        - `parameters.duration` (integer, optional): Generation duration, in
        seconds.

        - `parameters.resolution` (string, optional): Output resolution. The
        three Wan models are fixed at `720P`, `480P`, and `1080P` respectively;
        common values for HappyHorse are `720P` and `1080P`.

        - `parameters.ratio` (string, optional): Output aspect ratio, commonly
        used for text-to-video and reference-to-video.

        - `parameters.watermark` (boolean, optional): Whether to add a
        watermark.

        - `parameters.seed` (integer, optional): Random seed.


        Common model/mode differences:

        - `HappyHorse 聚合模型`: Supports model happyhorse-1.0; the aggregated model
        uses mode to distinguish the final model.

        - `HappyHorse 文生视频`: Supports model happyhorse-1.0-t2v; official-format
        text-to-video.

        - `HappyHorse 首帧图生视频`: Supports model happyhorse-1.0-i2v;
        official-format first-frame image-to-video.

        - `HappyHorse 参考生视频`: Supports model happyhorse-1.0-r2v; official-format
        multi-reference image-to-video.

        - `HappyHorse 视频编辑`: Supports model happyhorse-1.0-video-edit;
        official-format video editing.

        - `Wan 3.0 720P`: Supported model wan-3.0; Wan 3.0 official-format
        multimodal reference video generation.

        - `Wan 3.0 480P`: Supported model wan-3.0-480p; Wan 3.0 official-format
        call fixed at 480P.

        - `Wan 3.0 1080P`: Supported model wan-3.0-1080p; Wan 3.0
        official-format call fixed at 1080P.
      operationId: query__happyhorse_wan_task
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: Task ID, from the `id` returned when creating the task.
      responses:
        '200':
          description: Query successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  output:
                    type: object
                    properties:
                      task_id:
                        type: string
                        description: >-
                          The task ID returned when creating a task, used to
                          query the task.
                      task_status:
                        type: string
                        enum:
                          - PENDING
                          - RUNNING
                          - SUCCEEDED
                          - FAILED
                          - UNKNOWN
                        description: >-
                          Task status, common values `PENDING`, `RUNNING`,
                          `SUCCEEDED`, `FAILED`.
                      submit_time:
                        type: string
                      scheduled_time:
                        type: string
                      end_time:
                        type: string
                      video_url:
                        type: string
                        format: uri
                        description: >-
                          The URL of the generated video after the task
                          succeeds.
                      code:
                        type: string
                      message:
                        type: string
                  usage:
                    type: object
                    properties:
                      duration:
                        type: integer
                        description: Generation duration in seconds.
                      SR:
                        type: integer
                        description: Output resolution levels.
                      video_count:
                        type: integer
                  request_id:
                    type: string
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Use Bearer Token authentication.
        Format: `Authorization: Bearer sk-xxxxxx`

````