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

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

Vidu giao diện tạo video chính thức, đường dẫn công khai tuân theo giao thức chính thức của Vidu.

Mô hình công khai hiện tại: `viduq3-turbo`. Hỗ trợ text-to-video, image-to-video, video từ khung đầu-cuối, và reference-to-video. Cùng một mô hình cũng hỗ trợ tích hợp thông qua định dạng tương thích Sora của `/v1/videos`, các `mode` thường dùng là `t2v`, `i2v`, `i2v_first_last`, `reference_images`.

Bổ sung skeleton request công khai, cấu trúc truy vấn tác vụ và mẫu xác minh được khuyến nghị cho định dạng tạo video chính thức của Vidu, đường dẫn công khai giữ nguyên định dạng endpoint chính thức của Vidu.

Mô hình hỗ trợ:
viduq3-turbo

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 Vidu, hiện công khai `viduq3-turbo`.
- `prompt` (string, tùy chọn): prompt tạo video; bắt buộc với text-to-video, còn image-to-video/khung đầu-cuối/reference-to-video thì truyền theo nhu cầu nghiệp vụ.
- `images` (array[string], tùy chọn): đầu vào hình ảnh. image-to-video dùng 1 ảnh, khung đầu-cuối dùng 2 ảnh, reference-to-video dùng 1~7 ảnh.
- `videos` (array[string], tùy chọn): đầu vào đối tượng video tùy chọn cho reference-to-video, sử dụng theo năng lực mô hình chính thức của Vidu.
- `subjects` (array[object], tùy chọn): đầu vào theo định dạng thư viện chủ thể của reference-to-video, có thể bao gồm các trường như tên chủ thể, ảnh, video hoặc giọng.
- `duration` (integer, tùy chọn): độ dài video, tính bằng giây. `viduq3-turbo` thường dùng 5 giây, có thể đặt theo phạm vi chính thức.
- `resolution` (string, tùy chọn): độ phân giải đầu ra, giá trị phổ biến `540p`, `720p`, `1080p`.
- `aspect_ratio` (string, tùy chọn): tỷ lệ khung hình đầu ra, thường dùng cho text-to-video/reference-to-video, như `16:9`, `9:16`, `1:1`.
- `seed` (integer, tùy chọn): Seed ngẫu nhiên.
- `movement_amplitude` (string, tùy chọn): mức độ chuyển động, các giá trị phổ biến `auto`, `small`, `medium`, `large`.
- `audio` (boolean, tùy chọn): có bật xuất trực tiếp âm thanh và video hay không.
- `off_peak` (boolean, tùy chọn): có sử dụng tạo lệch giờ hay không.
- `watermark` (boolean, tùy chọn): Có thêm watermark hay không.

Khác biệt thường gặp giữa mô hình/chế độ:
- `Vidu 文生视频`: hỗ trợ mô hình viduq3-turbo; text-to-video theo định dạng chính thức.
- `Vidu 图生视频`: hỗ trợ mô hình viduq3-turbo; image-to-video một ảnh theo định dạng chính thức.
- `Vidu 首尾帧生视频`: hỗ trợ mô hình viduq3-turbo; video từ hai ảnh khung đầu-cuối theo định dạng chính thức.
- `Vidu 参考生视频`: hỗ trợ mô hình viduq3-turbo; reference-to-video với nhiều ảnh tham chiếu theo định dạng chính thức.



## OpenAPI

````yaml api-reference/vi/openapi.json GET /ent/v2/tasks/{task_id}/creations
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:
  /ent/v2/tasks/{task_id}/creations:
    get:
      tags:
        - Tạo video Vidu
      summary: Truy vấn tác vụ(Vidu)
      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)).


        Vidu giao diện tạo video chính thức, đường dẫn công khai tuân theo giao
        thức chính thức của Vidu.


        Mô hình công khai hiện tại: `viduq3-turbo`. Hỗ trợ text-to-video,
        image-to-video, video từ khung đầu-cuối, và reference-to-video. Cùng một
        mô hình cũng hỗ trợ tích hợp thông qua định dạng tương thích Sora của
        `/v1/videos`, các `mode` thường dùng là `t2v`, `i2v`, `i2v_first_last`,
        `reference_images`.


        Bổ sung skeleton request công khai, cấu trúc truy vấn tác vụ và mẫu xác
        minh được khuyến nghị cho định dạng tạo video chính thức của Vidu, đường
        dẫn công khai giữ nguyên định dạng endpoint chính thức của Vidu.


        Mô hình hỗ trợ:

        viduq3-turbo


        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 Vidu, hiện công
        khai `viduq3-turbo`.

        - `prompt` (string, tùy chọn): prompt tạo video; bắt buộc với
        text-to-video, còn image-to-video/khung đầu-cuối/reference-to-video thì
        truyền theo nhu cầu nghiệp vụ.

        - `images` (array[string], tùy chọn): đầu vào hình ảnh. image-to-video
        dùng 1 ảnh, khung đầu-cuối dùng 2 ảnh, reference-to-video dùng 1~7 ảnh.

        - `videos` (array[string], tùy chọn): đầu vào đối tượng video tùy chọn
        cho reference-to-video, sử dụng theo năng lực mô hình chính thức của
        Vidu.

        - `subjects` (array[object], tùy chọn): đầu vào theo định dạng thư viện
        chủ thể của reference-to-video, có thể bao gồm các trường như tên chủ
        thể, ảnh, video hoặc giọng.

        - `duration` (integer, tùy chọn): độ dài video, tính bằng giây.
        `viduq3-turbo` thường dùng 5 giây, có thể đặt theo phạm vi chính thức.

        - `resolution` (string, tùy chọn): độ phân giải đầu ra, giá trị phổ biến
        `540p`, `720p`, `1080p`.

        - `aspect_ratio` (string, tùy chọn): tỷ lệ khung hình đầu ra, thường
        dùng cho text-to-video/reference-to-video, như `16:9`, `9:16`, `1:1`.

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

        - `movement_amplitude` (string, tùy chọn): mức độ chuyển động, các giá
        trị phổ biến `auto`, `small`, `medium`, `large`.

        - `audio` (boolean, tùy chọn): có bật xuất trực tiếp âm thanh và video
        hay không.

        - `off_peak` (boolean, tùy chọn): có sử dụng tạo lệch giờ hay không.

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


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

        - `Vidu 文生视频`: hỗ trợ mô hình viduq3-turbo; text-to-video theo định dạng
        chính thức.

        - `Vidu 图生视频`: hỗ trợ mô hình viduq3-turbo; image-to-video một ảnh theo
        định dạng chính thức.

        - `Vidu 首尾帧生视频`: hỗ trợ mô hình viduq3-turbo; video từ hai ảnh khung
        đầu-cuối theo định dạng chính thức.

        - `Vidu 参考生视频`: hỗ trợ mô hình viduq3-turbo; reference-to-video với
        nhiều ảnh tham chiếu theo định dạng chính thức.
      operationId: queryViduTaskCreations
      parameters:
        - name: task_id
          in: path
          required: true
          schema:
            type: string
          description: ID tác vụ, lấy từ `task_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:
                  id:
                    type: string
                    description: ID của tác vụ.
                  state:
                    type: string
                    enum:
                      - created
                      - queueing
                      - processing
                      - success
                      - failed
                    description: >-
                      Trạng thái tác vụ, các giá trị thường gặp
                      `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 video được tạo sau khi tác vụ thành công.
                        cover_url:
                          type: string
                          format: uri
                          description: URL bìa sau khi tác vụ thành công.
                        watermarked_url:
                          type: string
                          format: uri
                          description: URL video có watermark.
                  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ụ.
      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`

````