# "văn bản thành video" Nguồn: https://docs.openaihub.net/api-45208991/ > 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/text2video: post: summary: văn bản thành video deprecated: false description: >- Tạo video dựa trên các từ trong lời nhắc văn bản. Có thể sử dụng phần thân yêu cầu camelCase gốc; `task_id` được trả về sau khi gửi và cần thăm dò trạng thái tác vụ. operationId: kling_text2video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/văn bản thành video - Kling parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - 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. 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-6 - kling-v2-master - kling-v2-1-master - kling-v2-5-turbo - kling-v2-6 - kling-v3 enumDetails: - value: kling-v1 displayName: V1 description: Mô hình cổ điển; thời lượng chỉ là 5/10 giây - value: kling-v1-6 displayName: V1.6 description: V1.6 được cải tiến; thời lượng chỉ là 5/10 giây - value: kling-v2-master displayName: Bản chính V2 description: Bản chính; thời lượng chỉ là 5/10 giây - value: kling-v2-1-master displayName: Bản chính V2.1 description: Bản chính V2.1; thời lượng chỉ là 5/10 giây - value: kling-v2-5-turbo displayName: V2.5 Turbo description: Hạng 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, hệ thống tính toán mức sử dụng của cổng mặc định là kling-v1, và nên điền rõ giá trị này. Giá trị phải là kling-v3 khi multi_shot=true; giá trị phải là 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 góc máy hay không. Khi là true, chỉ kling-v3 hỗ trợ tính năng này và prompt không hợp lệ; khi là false, không thể truyền shot_type / multi_prompt. negative_prompt: type: string description: >- Các từ gợi ý phủ định. Mô tả nội dung không mong muốn và truyền nội dung đó một cách minh bạch qua cổng. 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, phản hồi 400 sẽ được gửi. Giới hạn từ nguồn cấp trên ≤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' 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ỉ v2-6 / v3; v2-6 yêu cầu mode=pro - 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. Trường này có thể được truyền trong suốt; quy trình tính phí text2video hiện tại không nhận diện riêng voice_list (không giống image2video, trường này không ảnh hưởng đến hệ số hasVoiceId). refName: PostKlingV1VideosText2videoRequest x-apifox-orders: - aspect_ratio - callback_url - camera_control - cfg_scale - duration - external_task_id - 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 - mode - model_name - multi_prompt - multi_shot - negative_prompt - prompt - shot_type - sound - voice_list examples: '1': value: aspect_ratio: '16:9' duration: '5' mode: std model_name: kling-v1 prompt: >- Cảnh quay từ thiết bị bay không người lái về một đường bờ biển tuyệt đẹp vào lúc hoàng hôn vàng rực summary: '1' description: >- Khuyến nghị cho người mới: Vincent Video · Lộ trình gửi bài tối thiểu khả dụng '2': value: aspect_ratio: '16:9' duration: '10' mode: chuyên nghiệp model_name: kling-v2-master prompt: >- Cảnh quay điện ảnh tiến máy dolly vào trên mặt hồ miền núi phủ sương lúc bình minh, ánh sáng viền dịu nhẹ summary: '2' description: >- Đề xuất cho người mới bắt đầu: Vincent Video · V2 Master chất lượng cao 10 giây '3': value: aspect_ratio: '16:9' duration: '5' mode: chuyên nghiệp model_name: kling-v2-6 prompt: >- Một nhạc công đường phố chơi đàn vĩ cầm tại một góc phố trong thành phố dưới trời mưa, với âm thanh đám đông xung quanh sound: bật summary: '3' description: >- Đề xuất cho người mới bắt đầu: Vincent Video · Âm thanh chuyên nghiệp V2.6 '4': value: aspect_ratio: '16:9' duration: 8 mode: chuyên nghiệp model_name: kling-v3 prompt: >- Cảnh quay từ từ tiến gần vào một thám tử đang đọc hồ sơ vụ án dưới ánh đèn bàn summary: '4' description: >- Khuyến nghị cho người mới bắt đầu: Vincent Video · V3 8 giây mỗi giây '5': value: aspect_ratio: '16:9' cfg_scale: 0.7 duration: '5' mode: std model_name: kling-v1-6 negative_prompt: mờ, chất lượng thấp, hình mờ, chữ phủ lên prompt: >- Một chú ngựa trắng phi nước đại dọc bãi biển lúc bình minh, hiệu ứng nhòe chuyển động điện ảnh summary: '5' description: >- Khuyến nghị nâng cao: Vincent Video · Từ khóa phủ định và cfg_scale '6': value: aspect_ratio: '9:16' callback_url: https://example.com/callback duration: 6 external_task_id: '{{external_task_id}}' mode: 4k model_name: kling-v3 prompt: >- Chân dung cyberpunk dưới mưa neon, máy quay từ từ xoay quanh chủ thể summary: '6' description: >- Đề xuất nâng cao: Vincent Video · Lệnh gọi lại màn hình dọc 4K V3 '7': value: aspect_ratio: '16:9' duration: '6' mode: chuyên nghiệp model_name: kling-v3 multi_prompt: - duration: '2' index: 1 prompt: >- Cảnh toàn rộng mở đầu về đường chân trời của một thành phố tương lai lúc chạng vạng - duration: '2' index: 2 prompt: >- Cảnh quay trung, một người giao hàng chạy qua những con phố đông đúc với các biển hiệu neon - duration: '2' index: 3 prompt: >- Cận cảnh khuôn mặt đầy quyết tâm của người giao hàng, những giọt mưa đọng trên da multi_shot: true shot_type: tùy chỉnh summary: '7' description: 'Đề xuất nâng cao: Vincent Video · Tùy chỉnh đa ống kính V3' '8': value: aspect_ratio: '16:9' duration: '10' mode: chuyên nghiệp model_name: kling-v3 multi_shot: true prompt: >- Hành trình tua nhanh thời gian qua bốn mùa tại cùng một khoảng rừng trống shot_type: trí tuệ summary: '8' description: 'Đề xuất nâng cao: Vincent Video · Trí tuệ đa ống kính V3' '9': value: aspect_ratio: '16:9' camera_control: config: horizontal: 0 pan: 0 roll: 0 tilt: -2.5 vertical: 0 zoom: 1.5 type: simple duration: '5' mode: chuyên nghiệp model_name: kling-v2-5-turbo prompt: >- Chuyển động bay về phía trước như flycam trên một thung lũng núi sâu phủ sương mù buổi sáng summary: '9' description: >- Đề xuất nâng cao: Vincent Video · Điều khiển ống kính camera_control example_single: value: aspect_ratio: '16:9' duration: 5 mode: std model_name: kling-v1-6 prompt: Một con mèo đang chạy trên đồng cỏ, trời nắng đẹp. summary: example_single description: Video Vincent 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/văn bản thành video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208991-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ```