# "Video học viên tham chiếu nhiều hình ảnh" Nguồn: https://docs.openaihub.net/api-45208989/ > 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/videos/multi-image2video: post: summary: Video học viên tham chiếu nhiều hình ảnh deprecated: false description: '' operationId: post-kling-v1-videos-multi-image2video 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: - model_name - image_list - duration properties: aspect_ratio: type: string enum: - '16:9' - '9:16' - '1:1' enumDetails: - value: '16:9' displayName: Toàn cảnh description: Bố cục ngang màn hình rộng - value: '9:16' displayName: Chân dung description: Bố cục chân dung video ngắn - value: '1:1' displayName: Hình vuông description: Bố cục hình vuông description: >- Tỉ lệ khung hình, không bắt buộc. Cổng kết nối xác thực giá trị liệt kê khi được đặt; nếu không, hệ thống thượng nguồn sẽ quyết định. callback_url: type: string format: uri description: >- URL gọi lại khi tác vụ hoàn tất; phải có thể truy cập công khai; chuyển tiếp qua cổng. cfg_scale: type: number description: >- CFG, tùy chọn. Được chuyển tiếp nguyên trạng qua Gateway; phạm vi không được xác thực trước. duration: oneOf: - type: string enum: - '5' - '10' - type: integer enum: - 5 - 10 description: >- Thời lượng video (giây), bắt buộc. Chỉ được là 5 hoặc 10; chấp nhận chuỗi hoặc số nguyên; gateway chuẩn hóa thành chuỗi. Nếu thiếu, tính phí Relay: thời lượng phải là 5 hoặc 10. external_task_id: type: string description: >- ID tác vụ bên ngoài của bên gọi dùng để bảo đảm tính lũy đẳng/đối soát; không phải dữ liệu phản hồi.task_id. image_list: type: array items: type: object required: - image properties: image: type: string description: >- URL hoặc Base64 của hình ảnh tham chiếu, bắt buộc. Không sử dụng image_url (cổng chỉ đọc hình ảnh). image_fidelity: type: number description: >- Độ trung thực của ảnh; truyền thẳng qua cổng kết nối; phạm vi không được xác thực trước. image_url: type: string description: >- Trường URL hình ảnh dự phòng; quá trình xác thực của cổng kết nối bỏ qua trường này—hãy dùng image. type: type: string description: >- Cờ loại hình ảnh; gateway chuyển tiếp nguyên trạng; enum không được kiểm tra trước tại đây. x-apifox-orders: - image - image_fidelity - image_url - type x-apidog-orders: - image - image_fidelity - image_url - type description: >- Ảnh tham chiếu, bắt buộc, 1–4; mỗi ảnh cần có image (URL/Base64). Gateway chỉ kiểm tra không để trống; định dạng/kích thước do upstream quy định. mode: type: string enum: - std - pro enumDetails: - value: std displayName: Tiêu chuẩn description: Chế độ tiết kiệm chi phí - value: chuyên nghiệp displayName: Chất lượng cao description: chế độ hiệu năng cao, chi phí cao hơn description: >- chế độ tạo sinh. phương thức tính phí mặc định là `std` nếu bị bỏ qua. không hỗ trợ `4k`. model_name: type: string enum: - kling-v1-6 enumDetails: - value: kling-v1-6 displayName: V1.6 description: >- chỉ có mô hình dành cho video tham chiếu nhiều hình ảnh; thời lượng chỉ 5/10 giây description: >- Tên mô hình, bắt buộc. Cổng kết nối chỉ cho phép kling-v1-6; nếu không sẽ trả về 400. negative_prompt: type: string description: >- Lời nhắc phủ định, không bắt buộc. Được chuyển tiếp nguyên trạng qua cổng; độ dài không được xác thực trước (chỉ lời nhắc có kiểm tra giới hạn 2500). prompt: type: string description: >- Lời nhắc tích cực, không bắt buộc. Cổng kết nối không yêu cầu trường này; nếu được đặt, tối đa 2500 ký tự. Nên dùng để định hướng chuyển động/phong cách. x-apifox-orders: - aspect_ratio - callback_url - cfg_scale - duration - external_task_id - image_list - mode - model_name - negative_prompt - prompt x-apidog-orders: - aspect_ratio - callback_url - cfg_scale - duration - external_task_id - image_list - mode - model_name - negative_prompt - prompt examples: '1': value: aspect_ratio: '16:9' duration: '5' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: std model_name: kling-v1-6 prompt: >- Một cảnh điện ảnh kết hợp các chủ thể từ những hình ảnh tham chiếu, với chuyển động máy quay mượt mà summary: '1' '2': value: aspect_ratio: '9:16' duration: 5 image_list: - image: '{{image_url_1}}' mode: std model_name: kling-v1-6 prompt: >- Nhân vật quay người và bước về phía trước, ánh sáng tự nhiên dịu nhẹ summary: '2' '3': value: aspect_ratio: '16:9' duration: '10' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' - image: '{{image_url_3}}' - image: '{{image_url_4}}' model_name: kling-v1-6 prompt: >- Kết hợp cảnh, nhân vật, phong cách và ánh sáng từ tất cả hình ảnh tham chiếu summary: '3' '4': value: aspect_ratio: '16:9' cfg_scale: 0.5 duration: '10' image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: chuyên nghiệp model_name: kling-v1-6 negative_prompt: mờ, khuôn mặt biến dạng, chất lượng thấp, hình mờ prompt: >- Cảnh quay rộng hoành tráng, kết hợp cả hai nhân vật vào một cảnh hành động liền mạch summary: '4' '5': value: aspect_ratio: '1:1' callback_url: https://your-server.com/webhook/kling duration: '5' external_task_id: biz-mi2v-20260701-001 image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' - image: '{{image_url_3}}' mode: chuyên nghiệp model_name: kling-v1-6 prompt: >- Video theo phong cách biên tập thời trang với chuyển động lia máy năng động summary: '5' '6': value: aspect_ratio: '16:9' duration: 10 image_list: - image: '{{image_url_1}}' - image: '{{image_url_2}}' mode: std model_name: kling-v1-6 prompt: Chuyển cảnh quay chậm giữa hai cảnh tham chiếu summary: '6' 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-45208989-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ```