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

# Truy vấn tác vụ (HappyHorse và Wan)

> Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết [Định dạng tương thích với Sora tạo video](/api-reference/vi/tao-video-dinh-dang-tuong-thich-sora/tao-video)).

HappyHorse và giao diện tạo video Wan; đường dẫn công khai tuân theo giao thức chính thức của DashScope.

HappyHorse hỗ trợ `happyhorse-1.0`, `happyhorse-1.0-i2v`, `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, `happyhorse-1.0-video-edit`; Wan hỗ trợ `wan-3.0`, `wan-3.0-480p`, `wan-3.0-1080p`. Trong đó `happyhorse-1.0` là mô hình tổng hợp, cần phân biệt `t2v`, `i2v`, `r2v`, `video_edit` thông qua `mode`. Ba mô hình của Wan lần lượt cố định ở 720P, 480P, 1080P, hỗ trợ thời lượng 2～30 giây và tối đa 10 ảnh, 5 video, 5 audio tham chiếu.

Giao diện công khai giữ nguyên định dạng endpoint chính thức; tiền tố riêng cho từng kênh chỉ được ghép nội bộ khi gateway gửi yêu cầu tới kênh upstream cụ thể. Client không cần truyền rõ `X-DashScope-Async`; gateway hoặc lớp thích ứng kênh chính thức sẽ xử lý.

Bổ sung khung yêu cầu công khai, cấu trúc truy vấn tác vụ và mẫu xác thực đề xuất cho định dạng tạo video HappyHorse và Wan; đường dẫn công khai giữ nguyên định dạng endpoint chính thức của DashScope.

Mô hình hỗ trợ:
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

Các trường yêu cầu thống nhất:
- `model` (string, bắt buộc): Tên mô hình công khai của HappyHorse hoặc Wan. Wan hỗ trợ `wan-3.0`, `wan-3.0-480p`, `wan-3.0-1080p`; mô hình tổng hợp HappyHorse `happyhorse-1.0` cần dùng cùng `mode`.
- `mode` (string, tùy chọn): Chế độ mô hình tổng hợp, các giá trị thường dùng là `t2v`、`i2v`、`r2v`、`video_edit`. Với mô hình con cố định có thể không truyền.
- `input.prompt` (string, bắt buộc): Prompt tạo hoặc chỉnh sửa video.
- `input.media` (array[object], tùy chọn): Đầu vào đa phương tiện. Hỗ trợ `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio`; Wan hỗ trợ tối đa 10 ảnh, 5 video, 5 audio.
- `parameters.duration` (integer, tùy chọn): Thời gian tạo, tính bằng giây.
- `parameters.resolution` (string, tùy chọn): Độ phân giải đầu ra. Ba mô hình của Wan lần lượt cố định ở `720P`, `480P`, `1080P`; các giá trị phổ biến của HappyHorse là `720P`, `1080P`.
- `parameters.ratio` (string, tùy chọn): Tỷ lệ khung hình đầu ra, thường dùng cho tạo video từ văn bản và từ tham chiếu.
- `parameters.watermark` (boolean, tùy chọn): Có thêm watermark hay không.
- `parameters.seed` (integer, tùy chọn): Seed ngẫu nhiên.

Khác biệt thường gặp giữa mô hình/chế độ:
- `HappyHorse 聚合模型`: Hỗ trợ mô hình happyhorse-1.0; mô hình tổng hợp phân biệt mô hình cuối cùng qua mode.
- `HappyHorse 文生视频`: Hỗ trợ mô hình happyhorse-1.0-t2v; định dạng chính thức tạo video từ văn bản.
- `HappyHorse 首帧图生视频`: Hỗ trợ mô hình happyhorse-1.0-i2v; định dạng chính thức tạo video từ ảnh khung đầu.
- `HappyHorse 参考生视频`: Hỗ trợ mô hình happyhorse-1.0-r2v; định dạng chính thức tạo video từ nhiều ảnh tham chiếu.
- `HappyHorse 视频编辑`: Hỗ trợ mô hình happyhorse-1.0-video-edit; định dạng chính thức chỉnh sửa video.
- `Wan 3.0 720P`: Hỗ trợ mô hình wan-3.0; tạo video tham chiếu đa phương thức theo định dạng chính thức của Wan 3.0.
- `Wan 3.0 480P`: Hỗ trợ mô hình wan-3.0-480p; lời gọi theo định dạng chính thức của Wan 3.0 với 480P cố định.
- `Wan 3.0 1080P`: Hỗ trợ mô hình wan-3.0-1080p; lời gọi theo định dạng chính thức của Wan 3.0 với 1080P cố định.



## OpenAPI

````yaml api-reference/vi/openapi.json GET /api/v1/tasks/{task_id}
openapi: 3.0.0
info:
  title: Tài liệu tham khảo API của 出海营
  version: 1.0.0
  description: Public AI Gateway API Reference
servers:
  - url: https://api.aiid.edu.kg
security:
  - BearerAuth: []
tags:
  - name: Định dạng OpenAI (Chat)
  - name: Định dạng OpenAI (Responses)
  - name: Định dạng Gemini cho tạo ảnh
  - name: Tạo hình ảnhOpenAI định dạng DALL-E
  - name: Lấy danh sách mô hình
  - name: Tạo video HappyHorse và Wan
  - name: Định dạngKling tạo video
  - name: Định dạng Video Generation Omni và Veo
  - name: Tạo video Seedance
  - name: Định dạng tương thích Sora cho tạo video
  - name: Tạo video Vidu
  - name: Định dạng tác vụ tạo nhạc
paths:
  /api/v1/tasks/{task_id}:
    get:
      tags:
        - Tạo video HappyHorse và Wan
      summary: Truy vấn tác vụ (HappyHorse và Wan)
      description: >-
        Dòng này hỗ trợ định dạng tạo video OpenAI (xem chi tiết tại liên kết
        [Định dạng tương thích với Sora tạo
        video](/api-reference/vi/tao-video-dinh-dang-tuong-thich-sora/tao-video)).


        HappyHorse và giao diện tạo video Wan; đường dẫn công khai tuân theo
        giao thức chính thức của DashScope.


        HappyHorse hỗ trợ `happyhorse-1.0`, `happyhorse-1.0-i2v`,
        `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, `happyhorse-1.0-video-edit`;
        Wan hỗ trợ `wan-3.0`, `wan-3.0-480p`, `wan-3.0-1080p`. Trong đó
        `happyhorse-1.0` là mô hình tổng hợp, cần phân biệt `t2v`, `i2v`, `r2v`,
        `video_edit` thông qua `mode`. Ba mô hình của Wan lần lượt cố định ở
        720P, 480P, 1080P, hỗ trợ thời lượng 2～30 giây và tối đa 10 ảnh, 5
        video, 5 audio tham chiếu.


        Giao diện công khai giữ nguyên định dạng endpoint chính thức; tiền tố
        riêng cho từng kênh chỉ được ghép nội bộ khi gateway gửi yêu cầu tới
        kênh upstream cụ thể. Client không cần truyền rõ `X-DashScope-Async`;
        gateway hoặc lớp thích ứng kênh chính thức sẽ xử lý.


        Bổ sung khung yêu cầu công khai, cấu trúc truy vấn tác vụ và mẫu xác
        thực đề xuất cho định dạng tạo video HappyHorse và Wan; đường dẫn công
        khai giữ nguyên định dạng endpoint chính thức của DashScope.


        Mô hình hỗ trợ:

        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


        Các trường yêu cầu thống nhất:

        - `model` (string, bắt buộc): Tên mô hình công khai của HappyHorse hoặc
        Wan. Wan hỗ trợ `wan-3.0`, `wan-3.0-480p`, `wan-3.0-1080p`; mô hình tổng
        hợp HappyHorse `happyhorse-1.0` cần dùng cùng `mode`.

        - `mode` (string, tùy chọn): Chế độ mô hình tổng hợp, các giá trị thường
        dùng là `t2v`、`i2v`、`r2v`、`video_edit`. Với mô hình con cố định có thể
        không truyền.

        - `input.prompt` (string, bắt buộc): Prompt tạo hoặc chỉnh sửa video.

        - `input.media` (array[object], tùy chọn): Đầu vào đa phương tiện. Hỗ
        trợ `first_frame`, `last_frame`, `reference_image`, `reference_video`,
        `reference_audio`; Wan hỗ trợ tối đa 10 ảnh, 5 video, 5 audio.

        - `parameters.duration` (integer, tùy chọn): Thời gian tạo, tính bằng
        giây.

        - `parameters.resolution` (string, tùy chọn): Độ phân giải đầu ra. Ba mô
        hình của Wan lần lượt cố định ở `720P`, `480P`, `1080P`; các giá trị phổ
        biến của HappyHorse là `720P`, `1080P`.

        - `parameters.ratio` (string, tùy chọn): Tỷ lệ khung hình đầu ra, thường
        dùng cho tạo video từ văn bản và từ tham chiếu.

        - `parameters.watermark` (boolean, tùy chọn): Có thêm watermark hay
        không.

        - `parameters.seed` (integer, tùy chọn): Seed ngẫu nhiên.


        Khác biệt thường gặp giữa mô hình/chế độ:

        - `HappyHorse 聚合模型`: Hỗ trợ mô hình happyhorse-1.0; mô hình tổng hợp
        phân biệt mô hình cuối cùng qua mode.

        - `HappyHorse 文生视频`: Hỗ trợ mô hình happyhorse-1.0-t2v; định dạng chính
        thức tạo video từ văn bản.

        - `HappyHorse 首帧图生视频`: Hỗ trợ mô hình happyhorse-1.0-i2v; định dạng
        chính thức tạo video từ ảnh khung đầu.

        - `HappyHorse 参考生视频`: Hỗ trợ mô hình happyhorse-1.0-r2v; định dạng chính
        thức tạo video từ nhiều ảnh tham chiếu.

        - `HappyHorse 视频编辑`: Hỗ trợ mô hình happyhorse-1.0-video-edit; định dạng
        chính thức chỉnh sửa video.

        - `Wan 3.0 720P`: Hỗ trợ mô hình wan-3.0; tạo video tham chiếu đa phương
        thức theo định dạng chính thức của Wan 3.0.

        - `Wan 3.0 480P`: Hỗ trợ mô hình wan-3.0-480p; lời gọi theo định dạng
        chính thức của Wan 3.0 với 480P cố định.

        - `Wan 3.0 1080P`: Hỗ trợ mô hình wan-3.0-1080p; lời gọi theo định dạng
        chính thức của Wan 3.0 với 1080P cố định.
      operationId: query__happyhorse_wan_task
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: ID tác vụ, lấy từ `id` được trả về khi tạo tác vụ.
      responses:
        '200':
          description: Truy vấn thành công
          content:
            application/json:
              schema:
                type: object
                properties:
                  output:
                    type: object
                    properties:
                      task_id:
                        type: string
                        description: >-
                          ID tác vụ được trả về khi tạo tác vụ, dùng để truy vấn
                          tác vụ.
                      task_status:
                        type: string
                        enum:
                          - PENDING
                          - RUNNING
                          - SUCCEEDED
                          - FAILED
                          - UNKNOWN
                        description: >-
                          Trạng thái tác vụ, các giá trị thường gặp `PENDING`,
                          `RUNNING`, `SUCCEEDED`, `FAILED`.
                      submit_time:
                        type: string
                      scheduled_time:
                        type: string
                      end_time:
                        type: string
                      video_url:
                        type: string
                        format: uri
                        description: URL video được tạo sau khi tác vụ thành công.
                      code:
                        type: string
                      message:
                        type: string
                  usage:
                    type: object
                    properties:
                      duration:
                        type: integer
                        description: Thời gian tạo, tính bằng giây.
                      SR:
                        type: integer
                        description: Mức độ phân giải đầu ra.
                      video_count:
                        type: integer
                  request_id:
                    type: string
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Sử dụng xác thực Bearer Token.
        Định dạng: `Authorization: Bearer sk-xxxxxx`

````