> ## 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 tasks(Vidu)

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

Vidu official video generation API; the public path follows the Vidu official specification.

Current public model: `viduq3-turbo`. Supports text-to-video, image-to-video, start-and-end-frame video generation, and reference-based video generation. The same model also supports access via the `/v1/videos` Sora compatible format. Common `mode` are `t2v`, `i2v`, `i2v_first_last`, and `reference_images`.

Provides the public request skeleton, task query structure, and recommended validation template for the Vidu official video generation format, while the public path retains the Vidu official endpoint format.

Supported models:
viduq3-turbo

Unified request fields:
- `model` (string, required): Vidu public model name, currently public `viduq3-turbo`.
- `prompt` (string, optional): Video generation prompt; required for text-to-video, and passed as needed for image-to-video, start-and-end-frame, and reference-based video generation.
- `images` (array[string], optional): Image input. 1 image for image-to-video, 2 images for start-and-end-frame video generation, and 1~7 images for reference-based video generation.
- `videos` (array[string], optional): Optional video subject input for reference-based video generation, used according to the capabilities of the Vidu official model.
- `subjects` (array[object], optional): Subject-library format input for reference-based video generation; may include fields such as subject name, image, video, or voice timbre.
- `duration` (integer, optional): Video duration, in seconds. `viduq3-turbo` commonly uses 5 seconds; set it according to the official range.
- `resolution` (string, optional): Output resolution, common values are `540p`, `720p`, and `1080p`.
- `aspect_ratio` (string, optional): Output aspect ratio, commonly used for text-to-video/reference-based video generation, such as `16:9`, `9:16`, and `1:1`.
- `seed` (integer, optional): Random seed.
- `movement_amplitude` (string, optional): Motion intensity, common values are `auto`, `small`, `medium`, and `large`.
- `audio` (boolean, optional): Whether to enable direct audio-video output.
- `off_peak` (boolean, optional): Whether to use staggered generation.
- `watermark` (boolean, optional): Whether to add a watermark.

Common model/mode differences:
- `Vidu 文生视频`: Supported model viduq3-turbo; official-format text-to-video.
- `Vidu 图生视频`: Supported model viduq3-turbo; official-format single-image image-to-video.
- `Vidu 首尾帧生视频`: Supported model viduq3-turbo; official-format two-image start-and-end-frame video generation.
- `Vidu 参考生视频`: Supported model viduq3-turbo; official-format multi-reference image-to-video.



## OpenAPI

````yaml api-reference/en/openapi.json GET /ent/v2/tasks/{task_id}/creations
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:
  /ent/v2/tasks/{task_id}/creations:
    get:
      tags:
        - Video generation Vidu
      summary: Query tasks(Vidu)
      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)).


        Vidu official video generation API; the public path follows the Vidu
        official specification.


        Current public model: `viduq3-turbo`. Supports text-to-video,
        image-to-video, start-and-end-frame video generation, and
        reference-based video generation. The same model also supports access
        via the `/v1/videos` Sora compatible format. Common `mode` are `t2v`,
        `i2v`, `i2v_first_last`, and `reference_images`.


        Provides the public request skeleton, task query structure, and
        recommended validation template for the Vidu official video generation
        format, while the public path retains the Vidu official endpoint format.


        Supported models:

        viduq3-turbo


        Unified request fields:

        - `model` (string, required): Vidu public model name, currently public
        `viduq3-turbo`.

        - `prompt` (string, optional): Video generation prompt; required for
        text-to-video, and passed as needed for image-to-video,
        start-and-end-frame, and reference-based video generation.

        - `images` (array[string], optional): Image input. 1 image for
        image-to-video, 2 images for start-and-end-frame video generation, and
        1~7 images for reference-based video generation.

        - `videos` (array[string], optional): Optional video subject input for
        reference-based video generation, used according to the capabilities of
        the Vidu official model.

        - `subjects` (array[object], optional): Subject-library format input for
        reference-based video generation; may include fields such as subject
        name, image, video, or voice timbre.

        - `duration` (integer, optional): Video duration, in seconds.
        `viduq3-turbo` commonly uses 5 seconds; set it according to the official
        range.

        - `resolution` (string, optional): Output resolution, common values are
        `540p`, `720p`, and `1080p`.

        - `aspect_ratio` (string, optional): Output aspect ratio, commonly used
        for text-to-video/reference-based video generation, such as `16:9`,
        `9:16`, and `1:1`.

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

        - `movement_amplitude` (string, optional): Motion intensity, common
        values are `auto`, `small`, `medium`, and `large`.

        - `audio` (boolean, optional): Whether to enable direct audio-video
        output.

        - `off_peak` (boolean, optional): Whether to use staggered generation.

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


        Common model/mode differences:

        - `Vidu 文生视频`: Supported model viduq3-turbo; official-format
        text-to-video.

        - `Vidu 图生视频`: Supported model viduq3-turbo; official-format
        single-image image-to-video.

        - `Vidu 首尾帧生视频`: Supported model viduq3-turbo; official-format two-image
        start-and-end-frame video generation.

        - `Vidu 参考生视频`: Supported model viduq3-turbo; official-format
        multi-reference image-to-video.
      operationId: queryViduTaskCreations
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: Task ID, from the `task_id` returned when creating the task.
      responses:
        '200':
          description: Query successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Task ID.
                  state:
                    type: string
                    enum:
                      - created
                      - queueing
                      - processing
                      - success
                      - failed
                    description: >-
                      Task status. Common values: `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: >-
                            The URL of the generated video after the task
                            succeeds.
                        cover_url:
                          type: string
                          format: uri
                          description: Cover URL after the task succeeds.
                        watermarked_url:
                          type: string
                          format: uri
                          description: Watermarked video URL.
                  task_id:
                    type: string
                    description: >-
                      The task ID returned when creating a task, used to query
                      the task.
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |-
        Use Bearer Token authentication.
        Format: `Authorization: Bearer sk-xxxxxx`

````