# "Thử đồ ảo"

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

> 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:
  /kling/v1/images/kolors-virtual-try-on:
    post:
      summary: Thử đồ ảo
      deprecated: false
      description: ''
      operationId: post-kling-v1-images-kolors-virtual-try-on
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling
        - kling
      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: false
          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:
                - human_image
                - cloth_image
                - model_name
              properties:
                callback_url:
                  type: string
                  description: URL gọi lại được kích hoạt khi tác vụ hoàn tất
                cloth_image:
                  type: string
                  description: hình ảnh trang phục dùng để thử đồ ảo
                human_image:
                  type: string
                  description: >-
                    ảnh người đã tải lên;chấp nhận ảnh Base64 hoặc URL ảnh có
                    thể truy cập;định dạng ảnh được hỗ trợ.jpg / .jpeg /
                    .png;kích thước tệp ảnh không được vượt quá10MB, chiều
                    rộng/chiều cao ảnh phải ít nhất300px
                model_name:
                  type: string
                  description: >-
                    Liệt kê tên mô hình: kolors-virtual-try-on-v1,
                    kolors-virtual-try-on-v1-5
              x-apifox-orders:
                - callback_url
                - cloth_image
                - human_image
                - model_name
              x-apidog-orders:
                - callback_url
                - cloth_image
                - human_image
                - model_name
            examples:
              example:
                value:
                  callback_url: ''
                  cloth_image: >-
                    Vui lòng tải ảnh trực tiếp lên cuộc trò chuyện để tôi có thể
                    đọc và dịch tài liệu, đồng thời giữ nguyên Markdown, mã,
                    định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và
                    định dạng.
                  human_image: >-
                    https://h2.inkwai.com/bs2/upload-ylab-stunt/se/ai_portal_queue_mmu_image_upscale_aiweb/3214b798-e1b4-4b00-b7af-72b5b0417420_raw_image_0.jpg
                  model_name: kolors-virtual-try-on-v1
                summary: example
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-apidog-orders: []
              examples:
                example:
                  summary: example
                  value:
                    code: 0
                    data:
                      task_id: task_example_001
                    message: thành công
          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/Kling
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208986-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```