kling-3.0-turbo API

Sử dụng ID mẫu chính xác kling-3.0-turbo. Trường mô hình phải khớp chính xác với trang này.

Đầu ra mẫukling-3.0-turboPOST /v1/videos5.0s

Thông số: duration=5resolution=1080pratio=16:9

Câu lệnh: A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.

Yêu cầu tạo ra mẫu này

{
  "model": "kling-3.0-turbo",
  "prompt": "A skateboarder launches a kickflip over a concrete stair set in a skate park at golden hour. Low-angle slow-motion tracking shot, the board spins under his feet, dust and sunlight flare, he lands and rolls past the camera. Realistic physics, cinematic sports film, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Xác thực và điểm cuối

Sử dụng khóa API Modelflare với https://modelflare.dev/v1. Điểm vào cổng là POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Tạo nhiệm vụ

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "prompt": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot",
    "settings": {"duration": 5, "resolution": "720p"}
  }'

Thăm dò ý kiến và tải xuống

Lưu ID nhiệm vụ. Thăm dò GET /v1/videos/{task_id} và tải xuống với GET /v1/videos/{task_id}/content. URL kết quả có thể hết hạn, vì vậy hãy chuyển tệp ngay.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Ghi chú yêu cầu

Kling sử dụng các trường model_name, prompt, mode, duration, image_list hoặc contents / settings dành riêng cho họ; JSON gốc được bảo tồn và chuyển tiếp.

Tham số yêu cầu

Kling 3.0 Turbo chọn mô hình trong đường dẫn URL; không đặt model_name vào cơ thể. Chuyển văn bản thành video và chuyển hình ảnh sang video từ khung hình đầu tiên sử dụng các đường dẫn chính thức khác nhau.

Cánh đồng	Bắt buộc	Ghi chú
prompt	Có	Lời nhắc chuyển văn bản thành video; sử dụng giới hạn độ dài chính thức
contents[]	Có điều kiện	Đối với chuyển hình ảnh sang video, hãy bao gồm prompt và first_frame
settings.resolution	Không	720p / 1080p
settings.aspect_ratio	Không	16:9 / 9:16 / 1:1
settings.duration	Không	3–15 giây
options.watermark_info	Không	Cấu hình hình mờ

Giới hạn đầu vào và đầu ra

Chuyển văn bản thành video và hình ảnh khung hình đầu tiên thành video lần lượt sử dụng prompt và contents[]. Đầu ra là 720p hoặc 1080p trong 3–15 giây; lời nhắc chụp nhiều lần hỗ trợ tối đa sáu lần chụp.

Ví dụ về quy trình làm việc được ghi lại

Turbo sử dụng đường bao contents/settings/options được nâng cấp. ID mẫu vẫn nằm trong trường model của Modelflare và các cuộc gọi được thực hiện thông qua /v1/videos.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "列车缓慢驶过雨夜城市"}],
    "settings": {"resolution": "1080p", "aspect_ratio": "16:9", "duration": 5},
    "options": {"watermark_info": {"enabled": false}}
  }'

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-turbo",
    "contents": [{"type": "prompt", "text": "角色转身看向窗外"}, {"type": "first_frame", "url": "https://example.com/first.png"}],
    "settings": {"resolution": "1080p", "duration": 5}
  }'

Lỗi và tác vụ không thành công

Tham số mô hình không hợp lệ trả về 4xx cùng với ID yêu cầu. Tác vụ không đồng bộ cũng có thể bị lỗi sau khi quá trình tạo thành công; sử dụng error_code và error_message từ phản hồi thăm dò làm lý do nhiệm vụ cuối cùng. Đừng thử lại cùng một yêu cầu với hình dạng JSON khác.

Phạm vi được hỗ trợ

Trang này bao gồm các cuộc gọi chỉnh sửa và tạo mô hình Modelflare. Tính năng làm giàu bản đồ hoặc tìm kiếm, quản lý giọng nói và quản lý thư viện thành phần là các API tài nguyên nằm ngoài bề mặt lệnh gọi mô hình công khai này và không phải là các trường yêu cầu bắt buộc.

Định giá và thanh toán

Mô hình này sử dụng tính phí video theo giây. Xem trang định giá mẫu để biết giá khách hàng hiện tại, giá niêm yết tham khảo và thông số kỹ thuật đầy đủ.

Ghi chú

Trang này ghi lại giao diện công cộng của Modelflare; các trường và giới hạn hiển thị ở đây là hợp đồng hiện tại.