Submit a request
Create an async generation task and poll the task endpoint for terminal status updates.
Kling V2.6 supports text-to-video, image-to-video, and audio generation, making it suitable for video creation with audio.
Submit a task to MindVideo with your platform model slug. The response includes a request ID, task ID, normalized status, and estimated cost.
For production retries, send a unique Idempotency-Key per business request. Reusing the same key with the same payload returns the original task without charging again; reusing it with different input returns 409.
curl -X POST https://api.mindvideo.ai/api/v1/tasks \
-H "Authorization: Bearer mv_live_xxx" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: task_$(date +%s)" \
-d '{
"model": "kling-v2-6",
"input": {
"prompt": "A cinematic shot of a silver sports car driving through neon-lit rain",
"size": "16:9",
"duration": 5,
"mode": "std"
}
}'Every server-side request must include an API key in the Authorization header. Keys can be created, disabled, and deleted from the dashboard.
The platform maps runtime states into queued, processing, succeeded, failed, or cancelled so clients do not depend on model-specific fields.
Create an async generation task and poll the task endpoint for terminal status updates.
curl https://api.mindvideo.ai/api/v1/tasks/task_demo_model \
-H "Authorization: Bearer mv_live_xxx"curl https://api.mindvideo.ai/api/v1/tasks/task_demo_model/events \
-H "Authorization: Bearer mv_live_xxx"{
"request_id": "req_demo_model",
"task_id": "task_demo_model",
"status": "succeeded",
"cost_estimate": 0.0414,
"cost_actual": 0.0414,
"output": {
"videos": [
{
"url": "https://example.com/output/demo.mp4"
}
]
}
}Inputs can reference hosted files or compact data URIs depending on model constraints. Production apps should prefer stable hosted URLs.
{
"type": "object",
"required": [
"prompt"
],
"properties": {
"mode": {
"enum": [
"std",
"pro"
],
"type": "string",
"title": "Mode",
"default": "std",
"description": "Kling mode. std is the tested 720P tier, pro is the tested 1080P tier."
},
"seed": {
"type": "integer",
"title": "Seed",
"maximum": 2147483647,
"minimum": 0,
"x-playground": {
"advanced": true
}
},
"size": {
"enum": [
"16:9",
"9:16",
"1:1"
],
"type": "string",
"title": "Aspect ratio",
"default": "16:9"
},
"audio": {
"type": "boolean",
"title": "Audio",
"default": false,
"description": "Whether to generate synchronized audio. Available with pro mode."
},
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 2500,
"minLength": 1,
"x-playground": {
"rows": 6,
"widget": "textarea"
}
},
"duration": {
"enum": [
5,
10
],
"type": "integer",
"title": "Duration",
"default": 5
},
"cfg_scale": {
"type": "number",
"title": "CFG scale",
"default": 0.5,
"maximum": 1,
"minimum": 0,
"x-playground": {
"advanced": true
}
},
"image_url": {
"type": "string",
"title": "Reference image",
"description": "Optional reference image URL for image-to-video generation."
},
"image_urls": {
"type": "array",
"items": {
"type": "string"
},
"title": "Reference images",
"maxItems": 1,
"description": "Optional single reference image URL. The first item is sent as image_url."
},
"camera_control": {
"type": "object",
"title": "Camera control",
"x-playground": {
"advanced": true
}
},
"negative_prompt": {
"type": "string",
"title": "Negative prompt",
"maxLength": 2500,
"x-playground": {
"rows": 3,
"widget": "textarea",
"advanced": true
}
}
}
}{
"request_id": "req_demo_model",
"task_id": "task_demo_model",
"status": "succeeded",
"cost_estimate": 0.0414,
"cost_actual": 0.0414,
"output": {
"videos": [
{
"url": "https://example.com/output/demo.mp4"
}
]
}
}