Video
kling-3.0-turbo API
Use the exact kling-3.0-turbo model ID through Modelflare asynchronous video routing.
Use the exact model ID kling-3.0-turbo. The model field must match this page exactly.
Parameters: duration=5resolution=1080pratio=16:9
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.
{ "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"}Authentication and endpoint
Section titled “Authentication and endpoint”Use a Modelflare API key with https://modelflare.dev/v1. The gateway entry point is POST /v1/videos.
Authorization: Bearer YOUR_MODELFLARE_API_KEYCreate a task
Section titled “Create a task”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"} }'Poll and download
Section titled “Poll and download”Save the task ID. Poll GET /v1/videos/{task_id} and download with GET /v1/videos/{task_id}/content. Result URLs may expire, so transfer the file promptly.
curl https://modelflare.dev/v1/videos/TASK_ID \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"Request notes
Section titled “Request notes”Kling uses family-specific model_name, prompt, mode, duration, image_list, or contents / settings fields; native JSON is preserved and forwarded.
Request parameters
Section titled “Request parameters”Kling 3.0 Turbo selects the model in the URL path; do not put model_name in the body. Text-to-video and first-frame image-to-video use different official paths.
| Field | Required | Notes |
|---|---|---|
prompt |
Yes | Text-to-video prompt; use the official length limit |
contents[] |
Conditional | For image-to-video, include prompt and first_frame |
settings.resolution |
No | 720p / 1080p |
settings.aspect_ratio |
No | 16:9 / 9:16 / 1:1 |
settings.duration |
No | 3–15 seconds |
options.watermark_info |
No | Watermark configuration |
Input and output limits
Section titled “Input and output limits”Text-to-video and first-frame image-to-video use prompt and contents[] respectively. Output is 720p or 1080p for 3–15 seconds; multi-shot prompts support up to six shots.
Documented workflow examples
Section titled “Documented workflow examples”Turbo uses the upgraded contents/settings/options envelope. The model ID stays in Modelflare’s model field and calls enter through /v1/videos.
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}} }'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} }'Errors and failed tasks
Section titled “Errors and failed tasks”Invalid model parameters return a 4xx with a request ID. An asynchronous task can also enter failed after creation succeeds; use error_code and error_message from the poll response as the final task reason. Do not retry the same request with a different JSON shape.
Supported scope
Section titled “Supported scope”This page covers Modelflare model generation and editing calls. Search or map enrichment, voice management, and element-library management are resource APIs outside this public model-call surface and are not required request fields.
Pricing and billing
Section titled “Pricing and billing”This model uses per-second video billing. See the model pricing page for the current customer price, reference list price, and complete specification.
Media contract · v1
Official source: Kuaishou Kling
Contract parameters
| Intent field | Control | Options |
|---|---|---|
ratio | select | 16:9 / 9:16 / 1:1 |
resolution | select | 720p / 1080p |
duration | select | 3 / 5 / 8 / 10 / 15 |
Supported capability
allowed_values·ratio· 16:9, 9:16, 1:1allowed_values·resolution· 720p, 1080pallowed_values·duration· 3, 5, 8, 10, 15max_assets·reference_asset_ids· 1
Structured request example
text
Intent
{
"duration": 3,
"prompt": "A red paper kite over a quiet harbour at dusk.",
"ratio": "16:9",
"resolution": "720p"
}Provider request
{
"contents": [
{
"text": "A red paper kite over a quiet harbour at dusk.",
"type": "prompt"
}
],
"settings": {
"aspect_ratio": "16:9",
"duration": 3,
"resolution": "720p"
}
}reference
Intent
{
"duration": 3,
"prompt": "A red paper kite over a quiet harbour at dusk.",
"ratio": "16:9",
"resolution": "720p"
}Provider request
{
"contents": [
{
"text": "A red paper kite over a quiet harbour at dusk.",
"type": "prompt"
},
{
"type": "first_frame",
"url": "https://example.com/reference.png"
}
],
"settings": {
"aspect_ratio": "16:9",
"duration": 3,
"resolution": "720p"
}
}