# "Nhiều hình ảnh tham khảo"

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

> 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/multi-image2image:
    post:
      summary: Nhiều hình ảnh tham khảo
      deprecated: false
      description: ''
      operationId: post-kling-v1-images-multi-image2image
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/Nhiều hình ảnh tham khảo
        - 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:
                - model_name
                - subject_image_list
                - 'n'
              properties:
                aspect_ratio:
                  type: string
                  description: |-
                    Tỷ lệ khung hình (W:H)
                    enum: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9
                callback_url:
                  type: string
                  description: URL gọi lại được kích hoạt khi tác vụ hoàn tất
                external_task_id:
                  type: string
                  description: >-
                    Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía
                    nghiệp vụ
                model_name:
                  type: string
                  description: 'Liệt kê tên mô hình: kling-v2, kling-v2-1'
                'n':
                  type: integer
                  description: |-
                    Số lượng hình ảnh cần tạo
                    phạm vi: [1,9]
                prompt:
                  type: string
                  description: |-
                    Lời nhắc văn bản tích cực
                    Tối đa 2500 ký tự
                scene_image:
                  type: string
                  description: >-
                    Hình ảnh tham chiếu của cảnh

                    chấp nhận hình ảnh Base64 hoặc URL hình ảnh có thể truy cập
                    được
                style_image:
                  type: string
                  description: >-
                    Hình ảnh tham chiếu phong cách

                    chấp nhận hình ảnh Base64 hoặc URL hình ảnh có thể truy cập
                    được
                subject_image_list:
                  type: array
                  items:
                    type: object
                    required:
                      - subject_image
                    properties:
                      subject_image:
                        type: string
                        description: Hình ảnh tham chiếu của đối tượng
                    x-apifox-orders:
                      - subject_image
                    x-apidog-orders:
                      - subject_image
                  description: Yêu cầu từ 1–4 hình ảnh
              x-apifox-orders:
                - aspect_ratio
                - callback_url
                - external_task_id
                - model_name
                - 'n'
                - prompt
                - scene_image
                - style_image
                - subject_image_list
              x-apidog-orders:
                - aspect_ratio
                - callback_url
                - external_task_id
                - model_name
                - 'n'
                - prompt
                - scene_image
                - style_image
                - subject_image_list
            examples:
              example:
                value:
                  aspect_ratio: '16:9'
                  callback_url: ''
                  external_task_id: ''
                  model_name: kling-v2
                  'n': 1
                  prompt: Kết hợp dựa trên đặc điểm của hai hình ảnh
                  scene_image: ''
                  style_image: ''
                  subject_image_list:
                    - subject_image: >-
                        Vui lòng tải hình ảnh lên trực tiếp; tôi không thể truy
                        cập nội dung từ URL này để dịch.
                    - subject_image: >-
                        https://p2-fdl.klingai.com/ksc2/r4gHNdLJu7R_NKFagBrRhUo3pHsXVPKzNvpK03wlneD_9vJUZW305KBZOtLLDMPi3x_S2OA3_kElUJ9OTGiTMJEgl_JquTY_F18h_3T_bUuMAJMwv-Ab4Q0lxaqv5hkTkPf3RiMM-e8L6YDoiu_hqlEWNRoMfcF600L9QjzdeCNWHxt6l1yQHNN-2F1dlnIEEFRCUNtIYl4ld4CTrXU0zQ.png?cacheKey=ChtzZWN1cml0eS5rbGluZy5tZXRhX2VuY3J5cHQSsAG1PSTwbCq6_SmEkj2U-TQz3h6o_RMO0KUqJXA27NGRFxm-LmGTjaZHzO05ErU-1RdPfZjNK3M0uZQgSW8l2wVcgIou7OGlV4U0SpKzy-YxHgDwmjhlD389wl-rkRst5lcT-7rHQIBfz43n6hQpftalgQdQjzzX9Ba3mYFhNzCtRqeBJDHWZtmqR7Z_VjyVv6JuKd17mIdxVvUnUbrWebqODuRgWdconrxD-f2sXDo2JxoSbgFFnrpiqTZzapT733K7iU3CIiA53wUUSuPo6Nl3x-sMGxPpxWlgCCGZxjsdEzImNu8MQSgFMAE&x-kcdn-pid=112757&pkey=AAVbt25OjExCTX4XvCkIx0TYQ04HQw2NzKf4Lr5yxgJLFDF-iCUXHjGNnRg50Hk2CbkG5E905N4sXT4AkKNgSeYxfSs4YmmPRabsUxE-4lvP915Q3JT0nV1IvaUlXcBPwuY
                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/Nhiều hình ảnh tham khảo
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209011-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
