Kling Omni Video O3

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

kwaivgi/kling-video-o3/reference-to-video. 이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

관련 모델

Kling Omni Video O3 관련 모델 1

전체 매개변수, 출력 스키마 및 실시간 요금

AI 모델 API 마켓하나의 플랫폼, 모든 기능가장 인기이용약관이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
promptPrompttextarea—≤ 5000 chars
imagesImagesimage_upload—image/* · 1–7 items
resolutionGeneration Modeselect720P720P | 1080P
aspect_ratioAspect Ratioselect16:916:9 | 9:16 | 1:1
durationDurationselect53 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | …
soundSoundbooleanfalse—
keep_original_soundKeep Original Soundbooleantrue—
multi_shotMulti Shotboolean——
shot_typeShot Typeselect—customize | intelligence
multi_promptMulti Promptarray<object>——
↳durationDurationnumber5—
↳promptPrompttext——

전체 매개변수, 출력 스키마 및 실시간 요금

자세히 보기하나의 플랫폼, 모든 기능이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.
videosarray<string>

API

이미지, 동영상, 얼굴 바꾸기 모델 API를 살펴보세요. 모델을 시험한 뒤 하나의 통합 REST API로 연결할 수 있습니다.

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);

API 문서

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.