API Free WeekHundreds of APIs are free to call this week.Browse free APIs

Kling 3.0 Omni Pro Reference to Video

15% OFFkwaivgi/kling-video/3.0/omni/pro/reference-to-video

Kling 3.0 Omni Pro Reference to Video by Kuaishou generates a 3-10 second 1080p video that keeps characters and objects from reference images consistent.

Base price
$0.48$0.56USD / run
Execution
async
Model type
video
Input fields
5
Production route

Try the model

Playground

Open playground
Input
Take @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

Additional reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 7 total (elements + reference images + start image).
Video duration in seconds. Allowed values: 3, 4, 5, 6, 7, 8, 9, 10.
Elements (characters/objects) to include in the video. Reference in prompt as @Element1, @Element2, etc. Maximum 7 total (elements + reference images + start image).
The aspect ratio of the generated image. Allowed values: 16:9, 9:16, 1:1.
15% OFF
OutputExample

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.48 / run

Context & modalities

Input
Schema-defined
Output
video

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
KwaiVGI
Model ID
kwaivgi/kling-video/3.0/omni/pro/reference-to-video
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

Kling 3.0 Omni Pro Reference to Video

Kling 3.0 Omni Pro reference-to-video: cast characters and objects from reference images (and optional elements) into a new 3–10 second scene.

Fields

FieldTypeDefaultNotes
promptstring, required—Up to 2,500 characters.
imagesimage URL[], required—Reference images, referred to as @Image1, @Image2, … in the prompt.
duration3–105Output length in seconds.
elementsobject[]—Optional character or object elements to keep consistent.
aspect_ratio16:9 / 9:16 / 1:116:9Output frame shape.

Billing

$0.112 per output second.

OutputPrice
3s$0.336
5s (default)$0.56
10s$1.12

Failed runs are not charged.

Prompting

  • Refer to each reference as @Image1, @Image2 and give it a role.

Limits

  • Clips are 3–10 seconds.

Also on SandBase

Other Kling 3.0 Omni endpoints: kwaivgi/kling-video/3.0/omni/pro/image-to-video, kwaivgi/kling-video/3.0/omni/pro/video-to-video/edit.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
kwaivgi/kling-video/3.0/omni/pro/reference-to-video
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "kwaivgi/kling-video/3.0/omni/pro/reference-to-video",
  "images": [
    "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_images_0.png",
    "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_images_1.png"
  ],
  "prompt": "Take @Image1 as the start frame. Start with a high-angle satellite view of the ancient greenhouse ruin surrounded by nature. The camera swoops down and flies inside the building, revealing the character from @Element1 standing in the sun-drenched center. The camera then seamlessly transitions into a smooth 180-degree orbit around the character, moving to the back view. As the open backpack comes into focus, the camera continues to push forward, zooming deep inside the bag to reveal the glowing stone from @Element2 nestled inside. Cinematic lighting, hopeful atmosphere, 35mm lens. Make sure to keep it as the style of @Image2.",
  "duration": 5,
  "elements": [
    {
      "frontal_image_url": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_0.png",
      "reference_image_urls": [
        "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_1.png",
        "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_2.png"
      ]
    },
    {
      "frontal_image_url": "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_3.png",
      "reference_image_urls": [
        "https://static.sandbase.ai/examples/kwaivgi/kling-video/omni/pro/reference-to-video/input_element_4.png"
      ]
    }
  ],
  "aspect_ratio": "16:9"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
KwaiVGIVideo$0.56 / runJul 3, 2026
KwaiVGIVideoComing soonComing soon
KwaiVGIVideo$2.10 / runOct 5, 2026
KwaiVGIVideo$2.10 / runOct 5, 2026
KwaiVGIVideo$0.56 / runJul 6, 2026
KwaiVGIVideo$0.56 / runJul 6, 2026

Questions

FAQ

How do I call KwaiVGI Kling 3.0 Omni Pro Reference to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "kwaivgi/kling-video/3.0/omni/pro/reference-to-video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate KwaiVGI account?

No. One SandBase API key and balance gives you access to KwaiVGI Kling 3.0 Omni Pro Reference to Video and the other models in the catalog; you do not need to sign up with KwaiVGI separately.