Kling Omni Video O3

kwaivgi/kling-video-o3/reference-to-video

Kling Omni Video O3 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Supports audio generation. Ready-to-use REST API, best performance, no cold starts, affordable pricing.

Examples

Kling Omni Video O3 example 1

Parameters

NameTypeDefaultConstraintsDescription
promptPrompttextarea≤ 5000 charsThe positive prompt for the generation.
imagesImagesimage_uploadimage/* · 1–7 itemsReference images. With a reference video: image elements ≤ 4; without a reference video: ≤ 7
resolutionGeneration Modeselect720P720P | 1080P
aspect_ratioAspect Ratioselect16:916:9 | 9:16 | 1:1The aspect ratio of the generated video.
durationDurationselect53 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | …The duration of the generated media in seconds (3-15).
soundSoundbooleanfalseWhether to generate audio for the video.
keep_original_soundKeep Original SoundbooleantrueWhether to keep the original sound from the reference video.
multi_shotMulti ShotbooleanWhether to generate multi-shot video When true: the prompt parameter is invalid. When false: the shot_type and multi_prompt parameters are invalid
shot_typeShot Typeselectcustomize | intelligenceShot type for the generation.
multi_promptMulti Promptarray<object>List of multi-prompt elements for the generation.
durationDurationnumber5The duration of this shot in seconds.
promptPrompttextThe prompt for this shot.

API

Call this model through one unified REST API. Get a key on the API Keys page.

cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-video-o3/reference-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "Use reference image 1 as the female character and reference.",
    "images": [
      "https://assets-public.namifusion.com/marketplace/images/2026-04-14/54456cddb7de.png"
    ],
    "resolution": "720P",
    "aspect_ratio": "16:9",
    "duration": 5,
    "sound": false,
    "keep_original_sound": false,
    "shot_type": "intelligence"
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"
Python
import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-video-o3/reference-to-video",
    headers=HEADERS,
    json={
        "input": {
            "prompt": "Use reference image 1 as the female character and reference.",
            "images": [
                "https://assets-public.namifusion.com/marketplace/images/2026-04-14/54456cddb7de.png"
            ],
            "resolution": "720P",
            "aspect_ratio": "16:9",
            "duration": 5,
            "sound": False,
            "keep_original_sound": False,
            "shot_type": "intelligence"
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))
JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-video-o3/reference-to-video", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "prompt": "Use reference image 1 as the female character and reference.",
      "images": [
        "https://assets-public.namifusion.com/marketplace/images/2026-04-14/54456cddb7de.png"
      ],
      "resolution": "720P",
      "aspect_ratio": "16:9",
      "duration": 5,
      "sound": false,
      "keep_original_sound": false,
      "shot_type": "intelligence"
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

Documentation

Kling Video O3 Reference-to-Video

Effortless Character-Consistent Video Generation

Kling Omni Video O3 Reference-to-Video enables developers to create high-quality videos using reference images and optional reference videos. This model ensures identity consistency across frames, supports flexible aspect ratios and durations, and offers optional audio generation. With no cold starts and affordable pricing, it’s optimized for seamless integration into creative workflows.

🚀 Key Features

  • Character-Consistent Generation: Maintains the identity of characters and elements throughout the video.
  • Multi-Reference Support: Combine multiple reference images to create coherent scenes.
  • Optional Reference Video: Use a reference video for motion guidance, style transfer, or scene continuity.
  • Flexible Output: Supports multiple aspect ratios (16:9, 9:16, 1:1) and durations ranging from 3 to 15 seconds.
  • Sound Options: Keep original audio or generate synchronized sound effects.
  • Multi-Prompt Support: Guide scene transitions and narrative flow with chained prompt segments.

🛠️ Technical Specifications

ParameterTypeRequiredDefaultRange/OptionsDescription
promptstringYes--Text description of the desired scene and action
videostringNo--Reference video URL for motion or style guidance
imagesarrayNo[]≤4 with video, ≤7 without videoReference images of characters, elements, or styles
keep_original_soundbooleanNoTrue-Retain original sound from the reference video
soundbooleanNoFalse-Generate synchronized audio for the video
aspect_ratiostringNo16:916:9, 9:16, 1:1Aspect ratio of the generated video
durationintegerNo53–15Length of the generated video in seconds
shot_typestringNocustomizecustomize, intelligentEditing mode for generation
multi_promptarrayNo--Additional prompt segments for scene transitions

💰 Pricing

Attribute720P1080P
No Ref Video + Silent0.08400.1120
No Ref Video + With Sound0.11200.1400
With Ref Video + Silent0.12600.1680
With Ref Video + With Sound0.15400.1960

Billing Rules:

  • All prices are in USD.
  • Rates are determined by resolution, reference video usage, and audio status.
  • Supported duration: 3–15 seconds.

💡 Best Use Cases

  • Character-Driven Storytelling: Create scenes starring specific characters from reference images.
  • Social Media Content: Produce personalized short-form videos for platforms like TikTok and Instagram.
  • Marketing & Ads: Generate spokesperson or brand ambassador videos from still photos.
  • Creative Concepting: Combine multiple characters or elements into new scenarios for rapid ideation.
  • Style Transfer: Use a reference video to guide motion and visual style for new content.

🔗 Related Models

  • Kling Video O3 Image-to-Video: Animate a single image into video.
  • Kling Video O3 Text-to-Video: Generate videos from text prompts.
  • Kling Video O3 Video Edit: Edit existing videos with natural-language instructions.

Related models

VT Lip Sync
Video to VideoNamiFusion

VT Lip Sync

VT Lip Sync synchronizes mouth movements for a translated video by using the translated target video, translated audio, translated subtitle timing, and the original source video with its original subtitle timing.

from $0.200 / per run
Kling Omni Video O3
Video to VideoKling

Kling Omni Video O3

Kling Omni Video O3 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Supports audio generation. Ready-to-use REST API, best performance, no cold starts, affordable pricing.

from $0.380 / per run
Kling Omni Video O1 Reference-to-Video
Video to VideoKling

Kling Omni Video O1 Reference-to-Video

Kling Omni Video O1 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Ready-to-use REST API, best performance, no cold starts, affordable pricing.

from $0.380 / per run
Kling Omni Video O1 Reference-to-Video
Video to VideoKling

Kling Omni Video O1 Reference-to-Video

Kling Omni Video O1 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Ready-to-use REST API, best performance, no cold starts, affordable pricing.

from $0.630 / per run
Kling 3.0 Standard
Video to VideoKling

Kling 3.0 Standard

Kling 3.0 Standard Motion Control transfers motion from reference videos to animate still images. Upload a character image and a motion clip (dance, action, gesture), and the model extracts the movement to generate smooth, realistic video. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.

from $0.380 / per run
seedance-2-0 reference-to-video
Video to VideoDoubao

seedance-2-0 reference-to-video

The "Reference-to-Video" feature of Seedance 2.0 is the ultimate solution for visual stylistic unity. It precisely extracts artistic styles, lighting tones, or compositional intents from reference materials and seamlessly integrates them into newly generated videos, ensuring a highly consistent visual language for your creative series.

from $0.470 / per run
Alibaba WAN 2.6
Video to VideoAlibaba

Alibaba WAN 2.6

Alibaba WAN 2.6 Reference-to-Video seamlessly transforms character, prop, or scene references—supporting both single and multi-view inputs—into high-quality video sequences. It excels at preserving identity, style, and layout while delivering fluid, coherent motion. Experience peak performance via our production-ready REST API, featuring zero cold starts and cost-effective pricing.

from $0.750 / per run