# "ảnh-thành-video" Nguồn: https://docs.openaihub.net/api-45208984/ > 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/image2video: post: summary: ảnh-thành-video deprecated: false description: Tạo video bằng cách sử dụng hình ảnh đầu vào làm khung hình bắt đầu. operationId: kling_image2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - image - 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 (chiều rộng:chiều cao). Các ràng buộc từ hệ thống nguồn: thường dùng 16:9 / 9:16 / 1:1, cổng kết nối không liệt kê trước để kiểm tra. callback_url: type: string format: uri description: >- Địa chỉ gọi lại khi tác vụ hoàn tất. Gửi thông báo bằng phương thức POST sau khi tác vụ thượng nguồn hoàn tất; địa chỉ này phải có thể truy cập được qua mạng công cộng, và cổng kết nối chuyển tiếp nguyên trạng thông tin. camera_control: type: object properties: config: type: object properties: horizontal: type: number description: Chuyển vị ngang pan: type: number description: Di chuyển ngang (sang trái và sang phải) roll: type: number description: xoay tilt: type: number description: Di chuyển dọc (lên và xuống) vertical: type: number description: độ dịch chuyển theo phương thẳng đứng zoom: type: number description: thu phóng description: Cấu hình tham số chuyển động của ống kính x-apifox-orders: - horizontal - pan - roll - tilt - vertical - zoom x-apidog-orders: - horizontal - pan - roll - tilt - vertical - zoom type: type: string description: Loại điều khiển, chẳng hạn như đơn giản description: >- Điều khiển chuyển động của ống kính. Nếu tham số này không được truyền, mô hình sẽ tự động lựa chọn giá trị phù hợp; cổng trung gian sẽ truyền nguyên trạng và không kiểm tra trước phạm vi giá trị cụ thể. x-apifox-orders: - config - type x-apidog-orders: - config - type cfg_scale: type: number description: >- Mức độ tự do khi tạo (CFG). Giá trị càng lớn thì mức độ tương quan giữa kết quả được tạo và câu lệnh càng cao; cổng kết nối không kiểm tra trước phạm vi giá trị, còn các giới hạn của dịch vụ nguồn thường là 0~1. duration: oneOf: - type: string - type: integer description: >- Thời lượng video (giây), bắt buộc. Không phải kling-v3: chỉ 5 hoặc 10; kling-v3: 3~15. Hỗ trợ chuỗi hoặc số nguyên, cổng kết nối chuẩn hóa thành chuỗi. external_task_id: type: string description: >- ID tác vụ bên ngoài của bên gọi, được dùng để liên kết theo cách bảo đảm tính lũy đẳng và đối soát nghiệp vụ; trường `data.task_id` không nằm trong nội dung phản hồi. image: type: string description: >- Nhập URL hình ảnh hoặc Base64, bắt buộc. Được dùng làm tham chiếu cho khung hình đầu tiên của video; đây là trường cốt lõi của video tạo từ ảnh. Định dạng/kích thước/độ phân giải được xác minh bởi dịch vụ thượng nguồn, cổng chỉ xác minh rằng trường này không để trống. image_tail: type: string description: >- URL hoặc Base64 của hình ảnh khung hình kết thúc, không bắt buộc. Kết hợp với hình ảnh để thực hiện quá trình chuyển tiếp giữa khung hình đầu tiên và khung hình cuối cùng; nếu không được truyền vào, nội dung sẽ chỉ được tạo từ khung hình đầu tiên. Cổng truyền dữ liệu một cách minh bạch và không kiểm tra trước định dạng. mode: type: string enum: - std - pro - 4k 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 - value: 4k displayName: 4K description: Chỉ được hỗ trợ trên kling-v3 description: >- Tạo lược đồ. Phía thanh toán mặc định là std khi không được truyền. 4k chỉ dành cho kling-v3; kling-v2-6 yêu cầu pro để bật âm thanh. model_name: type: string enum: - kling-v1 - kling-v1-5 - kling-v1-6 - kling-v2-master - kling-v2-1 - kling-v2-1-master - kling-v2-5-turbo - kling-v2-6 - kling-v3 enumDetails: - value: kling-v1 displayName: V1 description: >- Chuyển hình ảnh thành video kiểu cổ điển; thời lượng chỉ 5/10 giây - value: kling-v1-5 displayName: V1.5 description: >- Mô hình chuyên biệt chuyển ảnh thành video; thời lượng chỉ 5/10 giây - value: kling-v1-6 displayName: V1.6 description: >- V1.6 tăng cường chuyển đổi hình ảnh thành video; thời lượng chỉ là 5/10 giây - value: kling-v2-master displayName: Bản chính V2 description: >- Làm chủ việc tạo video từ hình ảnh; thời lượng chỉ 5/10 giây - value: kling-v2-1 displayName: V2.1 description: >- Mô hình chuyên biệt chuyển ảnh thành video; thời lượng chỉ 5/10 giây - value: kling-v2-1-master displayName: Bản chính V2.1 description: >- V2.1 Làm chủ chuyển đổi hình ảnh thành video; thời lượng chỉ là 5/10 giây - value: kling-v2-5-turbo displayName: V2.5 Turbo description: Chuyển ảnh thành video Turbo; thời lượng chỉ 5/10 giây - value: kling-v2-6 displayName: V2.6 description: >- Hỗ trợ âm thanh (yêu cầu mode=pro + sound=on); thời lượng chỉ là 5/10 giây - value: kling-v3 displayName: V3 description: Hỗ trợ sound/4k/multi_shot; thời lượng 3–15s description: >- Tên mô hình. Khi không được truyền, việc tính toán mức sử dụng của cổng mặc định dùng kling-v1, và bạn nên điền rõ giá trị này. Đối với text2video, nên ưu tiên kling-v1-5 / kling-v2-1 hơn. Phải dùng kling-v3 khi multi_shot=true; phải dùng kling-v3 khi mode=4k. multi_prompt: type: array items: type: object required: - index - prompt - duration properties: duration: oneOf: - type: string - type: number - type: integer description: Thời lượng của bảng phân cảnh (giây), ≥1 index: type: integer description: Số thứ tự bảng phân cảnh, bắt đầu từ 1 prompt: type: string description: >- Từ ngữ lời nhắc tích cực của bảng phân cảnh, ≤512 ký tự x-apifox-orders: - duration - index - prompt x-apidog-orders: - duration - index - prompt description: >- Danh sách bảng phân cảnh tùy chỉnh. Bắt buộc khi shot_type=customize, tối đa 6 cảnh quay. Mỗi prompt của mirror ≤512, duration ≥1; tổng duration của từng mirror phải bằng duration cấp cao nhất (sai số ≤0.1). multi_shot: type: boolean description: >- Có nhiều ống kính hay không. Khi là `true`, chỉ `kling-v3` hỗ trợ tùy chọn này và `prompt` không hợp lệ; khi là `false`, không thể truyền `shot_type` / `multi_prompt`, và sẽ xảy ra lỗi 400 nếu các tham số này được truyền. negative_prompt: type: string description: >- Từ gợi ý phủ định. Mô tả nội dung không mong muốn (chẳng hạn như hình ảnh bị nhòe, chất lượng hình ảnh thấp, biến dạng, v.v.), và cổng kết nối sẽ truyền nguyên trạng nội dung đó. prompt: type: string description: >- Các từ gợi ý tích cực. Bắt buộc khi multi_shot=false (mặc định); không hợp lệ khi multi_shot=true, mã 400 sẽ được gửi. Mô tả chuyển động, cảnh quay và phong cách, giới hạn từ dịch vụ thượng nguồn là ≤2500 ký tự. shot_type: type: string enum: - customize - intelligence enumDetails: - value: tùy chỉnh displayName: Ảnh chụp tùy chỉnh description: >- Yêu cầu multi_prompt; tổng thời lượng của các cảnh phải bằng thời lượng cấp cao nhất - value: trí tuệ displayName: Ảnh chụp tự động description: >- `multi_prompt` không bắt buộc; mô hình tự động thực hiện shots description: >- Phương thức lập bảng phân cảnh. Bắt buộc khi multi_shot=true; không thể được truyền khi multi_shot=false. customize phải được sử dụng cùng với multi_prompt; intelligence sẽ tự động bị loại bỏ khỏi hệ thống nguồn. sound: type: string enum: - 'on' - 'off' enumDetails: - value: bật displayName: Bật âm thanh description: >- Chỉ hỗ trợ v2-6 / v3; v2-6 yêu cầu mode=pro; voice_list có thể ảnh hưởng đến hệ số tính phí - value: tắt displayName: Lên tiếng description: Mặc định không hiển thị thông báo description: >- Công tắc âm thanh. Cổng chỉ thực hiện xác minh mô hình/lược đồ đối với các giá trị khác null; kích hoạt tính phí âm thanh khi truyền on. Chỉ được hỗ trợ bởi kling-v2-6 / kling-v3; v2-6 yêu cầu mode=pro. voice_list: type: array items: type: object required: - voice_id properties: voice_id: type: string description: ID bản vá tùy chỉnh, từ giao diện tạo bản vá x-apifox-orders: - voice_id x-apidog-orders: - voice_id description: >- Danh sách âm thanh tùy chỉnh. Tham gia vào hệ số nhân thanh toán (hasVoiceId) khi sound=on và không rỗng; chỉ nhận diện đường dẫn image2video, không bao gồm text2video. Yêu cầu khả năng âm thanh của kling-v2-6 / kling-v3. refName: PostKlingV1VideosImage2videoRequest x-apifox-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - image - image_tail - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list x-apidog-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - image - image_tail - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list examples: '1': value: duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: Một chú gấu trúc uống cà phê trong một quán cà phê ấm cúng. summary: '1' description: >- Khuyến nghị cho người mới bắt đầu: Tusheng Video · Quy trình gửi tối thiểu khả dụng '2': value: duration: '5' image: '{{image_url}}' mode: std model_name: kling-v1 prompt: Một con mèo từ từ quay đầu về phía máy quay summary: '2' description: >- Khuyên dùng cho người mới bắt đầu: Video tạo từ hình ảnh · V1 tiêu chuẩn 5 giây '3': value: aspect_ratio: '16:9' duration: '10' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-master prompt: >- Cú máy dolly tiến mang phong cách điện ảnh, ánh sáng viền dịu summary: '3' description: >- Khuyên dùng cho người mới bắt đầu: Ảnh sang video · V2 Master chất lượng cao 10 giây '4': value: duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một nghệ sĩ đường phố chơi đàn violin, âm thanh náo nhiệt của đám đông sound: bật summary: '4' description: >- Khuyên dùng cho người mới bắt đầu: Video Tusheng · âm thanh chuyên nghiệp V2.6 '5': value: duration: 8 image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v3 prompt: Cảnh quay tiến chậm vào chủ thể với ánh sáng kịch tính summary: '5' description: >- Khuyên dùng cho người mới bắt đầu: Video từ ảnh · V3 8 giây mỗi giây '6': value: aspect_ratio: '16:9' cfg_scale: 0.7 duration: '5' image: '{{image_url}}' mode: std model_name: kling-v1-6 negative_prompt: mờ, chất lượng thấp, hình mờ prompt: Một con ngựa trắng đang chạy trên bãi biển lúc bình minh summary: '6' description: >- Khuyến nghị nâng cao: Video tạo từ hình ảnh · Từ khóa phủ định và cfg_scale '7': value: duration: '10' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một người dẫn chương trình thời sự nói trước máy quay trong trường quay sound: bật voice_list: - voice_id: '{{voice_id}}' summary: '7' description: >- Đề xuất nâng cao: Video tạo từ ảnh · Âm sắc được chỉ định cho âm thanh V2.6 '8': value: aspect_ratio: '9:16' callback_url: https://example.com/callback duration: 6 external_task_id: '{{external_task_id}}' image: '{{image_url}}' mode: 4k model_name: kling-v3 prompt: Chân dung cyberpunk, phản chiếu dưới mưa, độ tương phản cao summary: '8' description: >- Đề xuất nâng cao: Video Tusheng · Lệnh gọi lại màn hình dọc 4K V3 '9': value: duration: 6 image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v3 multi_prompt: - duration: '2' index: 1 prompt: Cảnh toàn cảnh đường chân trời thành phố lúc chạng vạng - duration: '2' index: 2 prompt: Trung cảnh, nhân vật bước vào khung hình - duration: '2' index: 3 prompt: Cận cảnh khuôn mặt, nụ cười nhẹ multi_shot: true shot_type: tùy chỉnh summary: '9' description: >- Đề xuất nâng cao: Video tạo từ hình ảnh · Tùy chỉnh đa ống kính V3 '10': value: camera_control: config: horizontal: 0 pan: 0 roll: 0 tilt: -2.5 vertical: 0 zoom: 1.5 type: simple duration: '5' image: '{{image_url}}' mode: chuyên nghiệp model_name: kling-v2-5-turbo prompt: >- Chuyển động tiến về phía trước như thiết bị bay không người lái trên thung lũng núi summary: '10' description: >- Đề xuất nâng cao: Video tạo từ ảnh · Điều khiển ống kính camera_control example_single: value: duration: 5 image: https://example.com/start-frame.jpg mode: std model_name: kling-v1-6 prompt: Máy quay từ từ tiến lại gần, nhân vật mỉm cười summary: example_single description: video từ ảnh responses: '200': description: Tác vụ đã được gửi thành công content: application/json: schema: type: object properties: code: type: integer description: Mã trạng thái nghiệp vụ examples: - 0 data: type: object properties: created_at: type: integer description: Thời điểm tạo (mili giây) task_id: type: string description: ID tác vụ, được dùng để kiểm tra định kỳ task_status: type: string enum: - submitted - processing - succeed - failed description: Trạng thái tác vụ updated_at: type: integer description: Cập nhật dấu thời gian (mili giây) description: >- Phần dữ liệu (thường là Base64 hoặc một đối tượng có cấu trúc) x-apifox-orders: - created_at - task_id - task_status - updated_at x-apidog-orders: - created_at - task_id - task_status - updated_at message: type: string description: Vui lòng cung cấp nội dung tài liệu cần dịch. examples: - thành công request_id: type: string description: ID truy vết yêu cầu refName: KlingTaskSubmitResponse x-apifox-orders: - code - data - message - request_id x-apidog-orders: - code - data - message - request_id examples: example: summary: example value: code: 0 data: created_at: 0 task_id: chuỗi task_status: đã gửi updated_at: 0 message: thành công request_id: chuỗi headers: {} x-apidog-name: Tác vụ đã được gửi 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/Video/Kling x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208984-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ```