Kling O3 API

Introduction

Kling O3 Reference to video casts a shot from up to 7 reference photos - characters, outfits, objects or places - instead of a single opening frame. Number the references in the prompt (<<<image_1>>>, <<<image_2>>>, and so on) and say what each one contributes; the prompt field takes up to 2,500 characters. Choose a length of 3 to 15 whole seconds, a resolution up to 4K, an aspect ratio, and whether to generate native audio.

Choose a Kling O3 mode by starting material

Key features

Multiple references, one shot

Unlike image-to-video, which starts from a single frame, reference-to-video takes up to 7 separate photos and combines what each one shows. Our dining-car example used three: a man, a room and an object, cast together in a scene none of the three photos depicted alone.

Each reference does one job

The prompt is where you assign the job: "<<<image_1>>> is the man, keep his coat and stubble" is what keeps that face and wardrobe intact instead of the model averaging it with the other references.

Sound generated with the cast scene

generate_audio adds ambience, effects and dialogue in the same pass. Keep expectations realistic for background sound described only in a phrase or two - it can render quietly in the final mix rather than as a dominant layer.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 51 credits for a 5-second clip ($0.51).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Put a person into a place they were never photographed in

Give a face its own reference and a location its own reference, and describe the action that puts them together - the kind of shot a single photo of either one could not supply on its own.

Keep a prop or an outfit consistent across shots

Reference a specific object - a piece of jewelry, a car, a signature outfit - alongside a character reference, and it recurs correctly instead of being redrawn slightly differently on every run.

Build a scene around three planned elements

When a shot depends on a specific person, a specific setting and a specific object all appearing together - like a letter, a room and its reader - references let you lock all three instead of describing them from scratch in prose.

Prompt guide & pro tips

Number every reference and name its job

Write "<<<image_1>>> is X, keep Y" for each reference in order. This is the single biggest factor in whether a reference carries through cleanly or gets blended with the others.

Use three or four clear photos over seven overlapping ones

More references are not automatically better. A handful of clear, distinct photos - one for the face, one for the outfit, one for the room - holds identity better than seven photos that overlap in what they show.

Describe sound as a background layer

When you ask for ambience like rain or train wheels alongside dialogue, expect it to sit low in the mix.

API quick start

Call the Kling O3 API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model kling/o3/reference-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "kling/o3/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5,
    "shot_type": "single"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Kling O3 API questions

All Kling models

Kling 3.0 is the pick for a single polished shot with first and last frames or Motion Control. O3 wins when you need reference photos, video editing or several modes in one place.

• Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom 51 credits for a 5-second clip
• Kling O3 APIKling’s unified model: create, animate, reference and edit up to 4KFrom 51 credits for a 5-second clip
• Kling 3.0 Turbo APIFaster Kling 3.0 with sound on every clipFrom 84 credits for a 5-second clip
• Kling Avatar 2.0 APIA portrait that speaks or sings your audio, up to 5 minutesFrom 7.68 credits per second
• Kling 2.6 API1080p clips with optional sound and motion controlFrom 52 credits for a 5-second clip
• Kling 2.5 Turbo API1080p clips with a soundtrack on every takeFrom 42 credits for a 5-second clip
• Kling 2.1 Master APISilent 1080p clips with fine prompt controlFrom 162 credits for a 5-second clip
• Kling 2.1 APIAnimate a frame at 720p or 1080p, with an optional end frameFrom 27 credits for a 5-second clip

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• Seedance 2.5 APIByteDance's newest: 30-second clips with native audioFrom 56 credits for a 5-second clip
• Vidu Q4 Preview APIUp to 4K clips with sound and spoken dialogueFrom 34 credits for a 5-second clip
• Wan 3.0 APIUp to 30-second clips with synced audioFrom 34 credits for a 5-second clip
• MiniMax H3 Max APIFast clips with ambience, effects and musicFrom 38 credits for a 5-second clip
• LTX 2.5 APILong 20-second takes up to 4K with a soundtrackFrom 68 credits for a 5-second clip

More about Kling O3

Try it

Kling O3 AI Video Generator onlineCreate videos with Kling O3 in PopNow

Compare

Kling 3.0 vs Kling O3

Docs

Kling O3 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get Kling O3 results without polling