# "Tạo video (hình ảnh tham chiếu)"

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

> 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:
  /v1/video/create:
    post:
      summary: Tạo video (hình ảnh tham chiếu)
      deprecated: false
      description: >-
        Omni-Flash · tạo video hợp nhất (`POST /v1/video/create`, tuyến vật lý
        chuyển tiếp VEO; xem `relay/veo` là tuyến chính).

        `model=omni-flash` / `omni-flash-edit` định tuyến đến quy trình
        Omni-Flash; `type` chọn khả năng:


        - `1` = chuyển văn bản thành video (chỉ yêu cầu `prompt`)

        - `2` = khung hình đầu/cuối (`images` yêu cầu 1-2 mục)

        - `3` = hình ảnh tham chiếu (`images` yêu cầu 1-3 mục)

        - `4` = chỉnh sửa video Omni-Flash (yêu cầu `input_reference`)


        Trả về `id` (ID tác vụ); thăm dò `GET /v1/video/query?id=` để nhận kết
        quả.
      operationId: omni_video_create
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/Định dạng hợp nhất cho video
        - Omni
      parameters:
        - name: Content-Type
          in: header
          description: Định dạng dữ liệu phần thân yêu cầu
          required: false
          example: application/json
          schema:
            type: string
        - name: Accept
          in: header
          description: Định dạng dữ liệu phản hồi mà máy khách dự kiến nhận được
          required: false
          example: application/json
          schema:
            type: string
        - name: Authorization
          in: header
          description: Khóa xác thực API, định dạng là Bearer + dấu cách + khóa API của bạn
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              properties:
                aspect_ratio:
                  type: string
                  enum:
                    - '16:9'
                    - '9:16'
                  description: tỷ lệ khung hình
                enable_sample:
                  type: boolean
                  description: >-
                    Dòng Omni-Flash chuyển sang 1080p (bỏ qua đối với các mẫu
                    4K)
                enable_upsample:
                  type: boolean
                  description: >-
                    Đã nâng cấp lên 1080p (khả dụng trên một số mẫu 4K nhất
                    định)
                images:
                  type: array
                  items:
                    type: string
                    format: uri
                  description: >-
                    Mảng URL hình ảnh (type=2 yêu cầu 1-2 hình ảnh, type=3 yêu
                    cầu 1-3 hình ảnh)
                input_reference:
                  type: string
                  description: >-
                    Video tham chieu chinh sua Omni-Flash (canh JSON duoc truyen
                    den URL hoac dataURI)
                model:
                  type: string
                  description: 'Tên mô hình (ví dụ: omni-flash, omni-flash-edit)'
                prompt:
                  type: string
                  description: Mô tả nội dung video
                seconds:
                  type: string
                  description: 'Thời lượng video (giây), ví dụ: "8"'
                size:
                  type: string
                  description: >-
                    Kích thước tùy chỉnh, tỷ lệ chiều rộng là 16:9 và tỷ lệ
                    chiều cao là 9:16. Khi aspect_ratio có hiệu lực, tham số này
                    không còn giá trị.
                type:
                  type: integer
                  enum:
                    - 1
                    - 2
                    - 3
                    - 4
                  description: >-
                    Loại tạo sinh: 1=Video từ văn bản, 2=Khung hình đầu và cuối,
                    3=Tham chiếu nhiều hình ảnh, 4=Chỉnh sửa video Omni-Flash
              allOf:
                - type: string
                - type: string
                - type: string
                - type: string
              refName: PostV1VideoCreateRequest
              x-apifox-orders:
                - aspect_ratio
                - enable_sample
                - enable_upsample
                - images
                - input_reference
                - model
                - prompt
                - seconds
                - size
                - type
              x-apidog-orders:
                - aspect_ratio
                - enable_sample
                - enable_upsample
                - images
                - input_reference
                - model
                - prompt
                - seconds
                - size
                - type
            examples:
              omni_flash:
                value:
                  model: omni-flash
                  prompt: xin chào thế giới
                summary: omni_flash
                description: >-
                  Khuyến nghị cho người mới bắt đầu: Yêu cầu tối thiểu cho người
                  mới bắt đầu · Kiến thức cơ bản về tạo sinh từ văn bản · mô
                  hình+lời nhắc
              omni_flash_2:
                value:
                  aspect_ratio: '16:9'
                  model: omni-flash
                  prompt: Cảnh hoàng hôn bên bờ biển quay từ trên không
                  seconds: '8'
                summary: omni_flash_2
                description: >-
                  Khuyên dùng cho người mới bắt đầu: Màn hình ngang tiêu chuẩn ·
                  Vincent Video · model+prompt+aspect_ratio+seconds
              omni_flash_3:
                value:
                  aspect_ratio: '9:16'
                  model: omni-flash
                  prompt: Nhân vật đường phố quay chậm
                  seconds: '8'
                summary: omni_flash_3
                description: >-
                  Khuyến nghị cho người mới bắt đầu: tiêu chuẩn màn hình dọc ·
                  Vincent Video · model+prompt+aspect_ratio+seconds
              omni_flash_4:
                value:
                  images:
                    - >-
                      https://ts1.tc.mm.bing.net/th/id/R-C.8dbf8e136e7d71653b63fdbd4d17fb6c?rik=KEcgD1%2fwKEKc9A&riu=http%3a%2f%2fimg.xintp.com%2f2019%2f12%2f10%2fxl5gp5kgesw.jpg&ehk=j5IVfJ0NDf2S9Ki9dJ7uXRMGlqubf9rR8TGsNLZP%2fMQ%3d&risl=&pid=ImgRaw&r=0
                    - >-
                      https://ts1.tc.mm.bing.net/th/id/R-C.ef98ae99612a621c19aaf5c02df8590a?rik=bpRpplfXRRo8pA&riu=http%3a%2f%2fimg95.699pic.com%2fphoto%2f50166%2f6903.jpg_wh300.jpg&ehk=yf0pMNdv%2bxIdqiWephK%2fg%2bt9K%2fTLDd8Db46yw8Q%2bSXM%3d&risl=&pid=ImgRaw&r=0
                  model: omni-flash
                  prompt: Chuyển tiếp mượt mà giữa khung hình đầu và cuối
                  seconds: '8'
                summary: omni_flash_4
                description: >-
                  Khuyên dùng cho người mới bắt đầu: Chuyển tiếp giữa hai hình
                  ảnh · Tạo khung hình đầu và cuối · mô hình+lời nhắc+hình
                  ảnh+số giây
              omni_flash_5:
                value:
                  images:
                    - >-
                      https://static.jokers.pub/upload/ai/728c4393-77ee-441a-99fa-ea1c294035a1/Image-91o3qgbn15t9o2k/1779515038884-1742.jpg
                  model: omni-flash
                  prompt: Tạo video giữ nguyên phong cách của chủ thể chính
                  seconds: '8'
                summary: omni_flash_5
                description: >-
                  Khuyến nghị cho người mới bắt đầu: tham chiếu một ảnh · tạo
                  ảnh tham chiếu đệm · mô hình+câu lệnh+ảnh+số giây
              omni_flash_6:
                value:
                  aspect_ratio: '9:16'
                  images:
                    - >-
                      https://ts2.tc.mm.bing.net/th/id/OIP-C.iBy7zllJXvjrzOH-VdwH_gHaEK?rs=1&pid=ImgDetMain&o=7&rm=3
                    - https://imgs.699pic.com/images/600/406/117.jpg!list1x.v2
                    - >-
                      https://ts2.tc.mm.bing.net/th/id/OIP-C.thJJkD55hZLuc-D86OW7bgHaEW?rs=1&pid=ImgDetMain&o=7&rm=3
                  model: omni-flash
                  prompt: >-
                    Kết hợp chủ thể và phong cách phối màu của ba hình ảnh tham
                    khảo
                  seconds: '8'
                summary: omni_flash_6
                description: >-
                  Khuyến nghị nâng cao: Kết hợp ba hình ảnh · Tạo hình ảnh tham
                  chiếu Mat · model+prompt+images+aspect_ratio+seconds
              omni_flash_7:
                value:
                  model: omni-flash
                  prompt: Video tua nhanh Thành phố Chân trời
                  seconds: '8'
                  type: 1
                summary: omni_flash_7
                description: >-
                  Khuyến nghị nâng cao: kiểu tường minh Vincent · lệnh gọi tương
                  thích với Vincent · mô hình+lời nhắc+kiểu+số giây
              omni_flash_edit:
                value:
                  input_reference: https://example.com/input.mp4
                  model: omni-flash-edit
                  prompt: Chuyển video gốc sang phong cách điện ảnh
                  type: 4
                summary: omni_flash_edit
                description: >-
                  Khuyến nghị cho người mới bắt đầu: Kiến thức cơ bản về chỉnh
                  sửa URL · Chỉnh sửa video ·
                  model+prompt+input_reference+seconds
              omni_flash_edit_datauri:
                value:
                  input_reference: >-
                    https://cdn.dealonhorizon.us/video/d2fa3281de7a69f3ac07b3451cf922e3ba609daad00d081674b283a63de67e54.mp4
                  model: omni-flash-edit
                  prompt: Nâng cao màu sắc và ánh sáng
                  type: 4
                summary: omni_flash_edit_datauri
                description: >-
                  Khuyến nghị nâng cao: Chỉnh sửa DataURI · Chỉnh sửa video ·
                  model+prompt+input_reference(dataURI)+seconds
      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
                refName: PostV1VideoCreateResponse
                x-apifox-orders:
                  - id
                  - status
                  - status_update_time
                x-apidog-orders:
                  - id
                  - status
                  - status_update_time
              examples:
                example:
                  summary: example
                  value:
                    id: omni-flash_X:task_uAbDkbRmcOafvSBBmNWwQkIA1gvTdoaX
                    status: queued
                    status_update_time: 1779950697931
          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/Veo/Đị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-45208976-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```