curl --request POST \
--url https://api.modellix.ai/api/v1/kling/kling-v3-omni-i2v \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"images": [
{
"url": "https://example.com/keyframe.jpg",
"type": "first_frame"
}
],
"prompt": "The subject slowly turns toward the camera"
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-v3-i2v-123",
"model_id": "model-123",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-v3-i2v-123"
}
}
}{
"code": 400,
"message": "Invalid parameters: parameter 'image' is required"
}{
"code": 401,
"message": "Authentication failed: invalid API key"
}{
"code": 429,
"message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}{
"code": 500,
"message": "Internal server error"
}Kling V3 Omni I2V
[Core Function] Kling V3 Omni I2V is a multimodal image-to-video model that animates from one or more reference images with stronger subject and style consistency. [Strengths] It accepts an images array for reference-led motion, aiming to preserve identity, wardrobe, and product look across the clip while supporting flexible duration and optional native audio. [Best For] Highly recommended for: character-consistent animation from design sheets, multi-reference product shots, comic or IP look locking, and I2V tasks where a single first frame is not enough. [Limitations] Do NOT use this model for simple one-image animation when cost or speed is the priority; use Kling V3 I2V or Kling V3 Turbo I2V. Do NOT use it when the primary input is text only; use Kling V3 Omni T2V or Kling V3 T2V. Do NOT use it for lip-sync avatar from audio alone; use Kling Avatar. [Routing] Choose Kling V3 Omni I2V when the user asks for Omni, multiple references, or strict visual consistency from images. Prefer Kling V3 I2V for standard single-image high quality; prefer Kling V3 Turbo I2V for fast or cheap single-image jobs.
curl --request POST \
--url https://api.modellix.ai/api/v1/kling/kling-v3-omni-i2v \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"images": [
{
"url": "https://example.com/keyframe.jpg",
"type": "first_frame"
}
],
"prompt": "The subject slowly turns toward the camera"
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-v3-i2v-123",
"model_id": "model-123",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-v3-i2v-123"
}
}
}{
"code": 400,
"message": "Invalid parameters: parameter 'image' is required"
}{
"code": 401,
"message": "Authentication failed: invalid API key"
}{
"code": 429,
"message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}{
"code": 500,
"message": "Internal server error"
}Authorizations
API Key authentication. Format: Bearer YOUR_API_KEY.
Body
Kling V3 Omni I2V — category slice of kling-v3-omni. images required; no videos.
Video generation prompt. May include both positive and negative descriptions in the same text. For custom multi-shot storyboards, use shot n, m, words; shot n, m, words; where n is the shot index (1-6), m is shot duration in seconds (each >= 1s; sum of all shot durations must equal total duration), and words is the per-shot prompt (max 512 characters). Max length 3072 (recommended <= 2500).
1 - 3072"shot 1, 2, The subject slowly turns toward the camera; shot 2, 3, Wind moves through their hair in a close-up;"
Required images (1-7). last_frame requires a first_frame in the same array.
1 - 7 elementsShow child attributes
Show child attributes
Official settings.audio for Omni I2V: native | off.
native, off "off"
When true, the model automatically plans multi-shot transitions. When false, generates a single continuous shot.
true
Output video resolution. Aspect ratio follows the first frame.
720p, 1080p, 4k "1080p"
Video duration in seconds.
3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 5