# "Tạo video"

Nguồn: https://docs.openaihub.net/api-45209079/

> API origin: `https://api.openaihub.net`. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.


## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /vidu-native/video/generations:
    post:
      summary: Tạo video
      deprecated: false
      description: ''
      operationId: post-vidu-native-video-generations
      tags:
        - >-
          OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ/Định dạng hợp nhất cho
          video
        - ví dụ
      parameters:
        - name: Content-Type
          in: header
          description: Content-Type của phần thân yêu cầu, thường là application/json
          required: true
          example: application/json
          schema:
            type: string
        - name: Accept
          in: header
          description: Content-Type dự kiến của phản hồi
          required: true
          example: application/json
          schema:
            type: string
        - name: Authorization
          in: header
          description: Khóa API Bearer
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
                - aspect_ratio
                - size
                - images
              properties:
                aspect_ratio:
                  type: string
                  description: 'tùy chọn: 2:3, 3:2, 1:1'
                images:
                  type: array
                  items:
                    type: string
                  description: liên kết hình ảnh
                model:
                  type: string
                  description: |-
                    Tên mô hình. Các giá trị liệt kê phổ biến:
                    viduq2
                    viduq2-pro
                    viduq2-turbo
                    viduq3-pro
                    viduq3-turbo
                  examples:
                    - viduq2
                prompt:
                  type: string
                  description: Lời nhắc
                size:
                  type: string
                  description: 720P hoặc 1080P
              x-apifox-orders:
                - aspect_ratio
                - images
                - model
                - prompt
                - size
              x-apidog-orders:
                - aspect_ratio
                - images
                - model
                - prompt
                - size
            examples:
              example:
                value:
                  aspect_ratio: '1:1'
                  images:
                    - https://example.com/ref.png
                  model: viduq2
                  prompt: Một chú mèo con đáng yêu đang chơi đùa trong vườn.
                  settings:
                    settings:
                      aspect_ratio: '16:9'
                      duration: 4
                      resolution: 1080p
                  size: 1080P
                summary: example
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - status
                  - status_update_time
                properties:
                  id:
                    type: string
                    description: ID tài nguyên hoặc tác vụ
                  status:
                    type: string
                    description: Trạng thái
                  status_update_time:
                    type: integer
                    description: Thời điểm cập nhật trạng thái
                x-apifox-orders:
                  - id
                  - status
                  - status_update_time
                x-apidog-orders:
                  - id
                  - status
                  - status_update_time
              examples:
                '1':
                  summary: '1'
                  value:
                    id: viduq2:1762241017-xTL0P9HvGF
                    status: pending
                    status_update_time: 1762241017286
                '2':
                  summary: '2'
                  value:
                    id: 033fa60e-f37c-4ff6-a44d-5585ffea938d
                    status: processing
                    status_update_time: 1764522528
          headers: {}
          x-apidog-name: ''
        '400':
          description: Yêu cầu không hợp lệ hoặc xác thực thất bại
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Yêu cầu không hợp lệ (mã yêu cầu:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại
        '401':
          description: Khóa API bị thiếu hoặc không hợp lệ
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Mã thông báo không hợp lệ (request id:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ
      security: []
      x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Ví dụ/Định dạng hợp nhất cho video
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209079-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
