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

# 查询任务(Vidu)

> 该系列支持OpenAI视频生成格式（详见链接 [视频生成Sora兼容格式](/api-reference/cn/视频生成sora兼容格式/创建视频)）。

Vidu 官方视频生成接口，公开路径遵循 Vidu 官方协议。

当前公开模型：`viduq3-turbo`。支持文生视频、图生视频、首尾帧生视频、参考生视频。同一模型也支持通过 `/v1/videos` Sora 兼容格式接入，常用 `mode` 为 `t2v`、`i2v`、`i2v_first_last`、`reference_images`。

补充 Vidu 官方视频生成格式的公开请求骨架、任务查询结构和推荐验证模板，公开路径保持 Vidu 官方端点格式。

支持模型：
viduq3-turbo

统一请求字段：
- `model` (string, 必填): Vidu 对外模型名，当前公开 `viduq3-turbo`。
- `prompt` (string, 可选): 视频生成提示词；文生视频必填，图生/首尾帧/参考生视频按业务需要传。
- `images` (array[string], 可选): 图片输入。图生视频 1 张，首尾帧 2 张，参考生视频 1~7 张。
- `videos` (array[string], 可选): 参考生视频可选视频主体输入，按 Vidu 官方模型能力使用。
- `subjects` (array[object], 可选): 参考生视频主体库格式输入，可包含主体名称、图片、视频或音色等字段。
- `duration` (integer, 可选): 视频时长，单位秒。`viduq3-turbo` 常用 5 秒，可按官方范围设置。
- `resolution` (string, 可选): 输出分辨率，常见值 `540p`、`720p`、`1080p`。
- `aspect_ratio` (string, 可选): 输出宽高比，文生/参考生视频常用，如 `16:9`、`9:16`、`1:1`。
- `seed` (integer, 可选): 随机种子。
- `movement_amplitude` (string, 可选): 运动幅度，常见值 `auto`、`small`、`medium`、`large`。
- `audio` (boolean, 可选): 是否开启音视频直出。
- `off_peak` (boolean, 可选): 是否使用错峰生成。
- `watermark` (boolean, 可选): 是否添加水印。

常见模型/模式差异：
- `Vidu 文生视频`: 支持模型 viduq3-turbo；官方格式文生视频。
- `Vidu 图生视频`: 支持模型 viduq3-turbo；官方格式单图图生视频。
- `Vidu 首尾帧生视频`: 支持模型 viduq3-turbo；官方格式首尾帧双图生视频。
- `Vidu 参考生视频`: 支持模型 viduq3-turbo；官方格式多参考图生视频。



## OpenAPI

````yaml api-reference/cn/openapi.json GET /ent/v2/tasks/{task_id}/creations
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:
  /ent/v2/tasks/{task_id}/creations:
    get:
      tags:
        - 视频生成Vidu格式
      summary: 查询任务(Vidu)
      description: >-
        该系列支持OpenAI视频生成格式（详见链接
        [视频生成Sora兼容格式](/api-reference/cn/视频生成sora兼容格式/创建视频)）。


        Vidu 官方视频生成接口，公开路径遵循 Vidu 官方协议。


        当前公开模型：`viduq3-turbo`。支持文生视频、图生视频、首尾帧生视频、参考生视频。同一模型也支持通过 `/v1/videos`
        Sora 兼容格式接入，常用 `mode` 为 `t2v`、`i2v`、`i2v_first_last`、`reference_images`。


        补充 Vidu 官方视频生成格式的公开请求骨架、任务查询结构和推荐验证模板，公开路径保持 Vidu 官方端点格式。


        支持模型：

        viduq3-turbo


        统一请求字段：

        - `model` (string, 必填): Vidu 对外模型名，当前公开 `viduq3-turbo`。

        - `prompt` (string, 可选): 视频生成提示词；文生视频必填，图生/首尾帧/参考生视频按业务需要传。

        - `images` (array[string], 可选): 图片输入。图生视频 1 张，首尾帧 2 张，参考生视频 1~7 张。

        - `videos` (array[string], 可选): 参考生视频可选视频主体输入，按 Vidu 官方模型能力使用。

        - `subjects` (array[object], 可选): 参考生视频主体库格式输入，可包含主体名称、图片、视频或音色等字段。

        - `duration` (integer, 可选): 视频时长，单位秒。`viduq3-turbo` 常用 5 秒，可按官方范围设置。

        - `resolution` (string, 可选): 输出分辨率，常见值 `540p`、`720p`、`1080p`。

        - `aspect_ratio` (string, 可选): 输出宽高比，文生/参考生视频常用，如 `16:9`、`9:16`、`1:1`。

        - `seed` (integer, 可选): 随机种子。

        - `movement_amplitude` (string, 可选): 运动幅度，常见值
        `auto`、`small`、`medium`、`large`。

        - `audio` (boolean, 可选): 是否开启音视频直出。

        - `off_peak` (boolean, 可选): 是否使用错峰生成。

        - `watermark` (boolean, 可选): 是否添加水印。


        常见模型/模式差异：

        - `Vidu 文生视频`: 支持模型 viduq3-turbo；官方格式文生视频。

        - `Vidu 图生视频`: 支持模型 viduq3-turbo；官方格式单图图生视频。

        - `Vidu 首尾帧生视频`: 支持模型 viduq3-turbo；官方格式首尾帧双图生视频。

        - `Vidu 参考生视频`: 支持模型 viduq3-turbo；官方格式多参考图生视频。
      operationId: queryViduTaskCreations
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: 任务 ID，来自创建任务返回的 `task_id`。
      responses:
        '200':
          description: 查询成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: 任务 ID。
                  state:
                    type: string
                    enum:
                      - created
                      - queueing
                      - processing
                      - success
                      - failed
                    description: >-
                      任务状态，常见值
                      `created`、`queueing`、`processing`、`success`、`failed`。
                  err_code:
                    type: string
                  payload:
                    type: string
                  creations:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        url:
                          type: string
                          format: uri
                          description: 任务成功后的生成视频 URL。
                        cover_url:
                          type: string
                          format: uri
                          description: 任务成功后的封面 URL。
                        watermarked_url:
                          type: string
                          format: uri
                          description: 带水印视频 URL。
                  task_id:
                    type: string
                    description: 创建任务返回的任务 ID，用于查询任务。
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        使用 Bearer Token 认证。
        格式: `Authorization: Bearer sk-xxxxxx`

````