> ## 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/zh-tw/%E5%BD%B1%E7%89%87%E7%94%9F%E6%88%90sora%E7%9B%B8%E5%AE%B9%E6%A0%BC%E5%BC%8F/%E5%BB%BA%E7%AB%8B%E5%BD%B1%E7%89%87)）。

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 三個模型分別固定 720P、480P、1080P，支援 2～30 秒及最多 10 圖、5 影片、5 音訊參考。

公開介面維持官方端點格式；渠道專用前綴僅用於閘道請求特定上游渠道時內部拼接。用戶端不需要明確傳入 `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 三個模型分別固定 `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/zh-tw/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: 影片生成 Seedance 格式
  - name: 影片生成Sora相容格式
  - name: 影片生成 Vidu 格式
  - name: 音樂生成任務格式
paths:
  /api/v1/tasks/{task_id}:
    get:
      tags:
        - 影片生成HappyHorse與 Wan
      summary: 查詢任務(HappyHorse與 Wan)
      description: >-
        此系列支援OpenAI影片生成格式（詳見連結
        [影片生成Sora相容格式](/api-reference/zh-tw/%E5%BD%B1%E7%89%87%E7%94%9F%E6%88%90sora%E7%9B%B8%E5%AE%B9%E6%A0%BC%E5%BC%8F/%E5%BB%BA%E7%AB%8B%E5%BD%B1%E7%89%87)）。


        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 三個模型分別固定
        720P、480P、1080P，支援 2～30 秒及最多 10 圖、5 影片、5 音訊參考。


        公開介面維持官方端點格式；渠道專用前綴僅用於閘道請求特定上游渠道時內部拼接。用戶端不需要明確傳入
        `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 三個模型分別固定
        `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`

````