# "Tạo video đa tác tử (đa tham chiếu)"

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

> 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:
  /openapi/v2/video/fusion/generate:
    post:
      summary: Tạo video đa tác tử (đa tham chiếu)
      deprecated: false
      description: >-
        Tạo video bằng Pixverse; thăm dò kết quả qua GET
        /openapi/v2/video/result/{id} sau khi gửi yêu cầu.
      operationId: pixverse_video_fusion_generate
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ali Pix
        - Pixverse
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              properties:
                aspect_ratio:
                  type: string
                  enum:
                    - '16:9'
                    - '9:16'
                    - '1:1'
                    - '4:3'
                    - '3:4'
                  description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1'
                duration:
                  type: integer
                  enum:
                    - 5
                    - 8
                    - 10
                  description: Thời lượng (giây hoặc đơn vị do nền tảng quy định)
                img_ids:
                  type: array
                  items:
                    type: integer
                  description: Danh sách mã định danh tài nguyên hình ảnh
                model:
                  type: string
                  enum:
                    - v3.5
                    - v4
                    - v4.5
                    - v5
                    - v5.5
                    - v6
                  description: phiên bản mô hình
                  examples:
                    - v5.5
                negative_prompt:
                  type: string
                  description: Lời nhắc phủ định (nội dung cần tránh)
                prompt:
                  type: string
                  description: Mô tả video
                quality:
                  type: string
                  enum:
                    - 360p
                    - 540p
                    - 720p
                    - 1080p
                  description: Mức chất lượng đầu ra
                seed:
                  type: integer
                  description: >-
                    Hạt giống ngẫu nhiên; cùng một hạt giống sẽ tạo ra kết quả
                    có thể tái lập
              refName: PostOpenapiV2VideoFusionGenerateRequest
              x-apifox-orders:
                - aspect_ratio
                - duration
                - img_ids
                - model
                - negative_prompt
                - prompt
                - quality
                - seed
              x-apidog-orders:
                - aspect_ratio
                - duration
                - img_ids
                - model
                - negative_prompt
                - prompt
                - quality
                - seed
            examples:
              v5_5:
                value:
                  aspect_ratio: '16:9'
                  duration: 5
                  model: v5.5
                  prompt: Một con mèo đang chạy trên cỏ
                  quality: 720p
                summary: v5_5
                description: Video Vincent
      responses:
        '200':
          description: thành công
          content:
            application/json:
              schema:
                type: object
                x-apidog-orders: []
              examples:
                example:
                  summary: example
                  value:
                    ErrCode: 0
                    ErrMsg: thành công
                    RespData:
                      id: 123456
          headers: {}
          x-apidog-name: thành công
        '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/Hình ảnh/Ali Pix
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208938-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```