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

Kling V4 Reference to Video

kwaivgi/kling-video/v4/reference-to-video

Kling V4 Reference to Video by Kuaishou generates a 3-30 second video that keeps characters, objects and motion from reference images and videos.

Base price
$1.18USD / run
Execution
async
Model type
video
Input fields
6
Production route

Try the model

Playground

Open playground
Input
Text prompt. Refer to references as @Image1, @Video1, ...

PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 10

Up to 10 reference images, referenced as @Image1, @Image2, ...
Up to 5 reference videos (3-30s each, 30s combined), referenced as @Video1, ... Video references switch to the input-plus-output price.
Output frame shape. auto follows the references. Allowed values: auto, 16:9, 9:16, 1:1, 21:9.
Output resolution. Allowed values: 720p, 1080p.
330
Output length in seconds (3-30). Range: 3 to 30.
OutputExample

Examples

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

Model card

Specifications

Pricing

Base price
$1.18 / 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/v4/reference-to-video
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

Kling V4 Reference to Video

Kling V4 reference-to-video keeps characters, objects and motion from reference images and videos in a new 3–30 second clip.

Fields

FieldTypeDefaultNotes
promptstring, required—Refer to inputs as @Image1, @Video1, …
imagesimage URL[]—Up to 10 reference images.
videosvideo URL[]—Up to 5 reference videos, 3–30s each, 30s combined.
aspect_ratioauto / 16:9 / 9:16 / 1:1 / 21:916:9auto follows the references.
resolution720p / 1080p1080pOutput resolution.
duration3–305Output length in seconds.

Billing

Without reference videos: $0.157 per output second at 720p, $0.235 at 1080p. With reference videos: $0.094 (720p) or $0.141 (1080p) per second of output plus input, where the input side counts at least as long as the output. The quote before submission assumes 30 seconds of reference video when the length cannot be read.

RequestPrice
5s, 1080p, images only (default)$1.175
5s, 720p, images only$0.785
5s, 1080p, 8s reference video$1.833
10s, 720p, 4s reference video$1.88
Failed runs are not charged.

Prompting

  • Name each reference in the prompt, e.g. "@Image1 walks into the scene from @Video1".

Limits

  • Clips are 3–30 seconds; reference videos 3–30 seconds.

Also on SandBase

Other Kling V4 endpoints: kwaivgi/kling-video/v4/text-to-video, kwaivgi/kling-video/v4/image-to-video, kwaivgi/kling-video/v4/reference-to-video, kwaivgi/kling-video/v4/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/v4/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/v4/reference-to-video",
  "prompt": "@Element1 and @Element2 are having dinner at the table in @Image1",
  "duration": 5,
  "resolution": "1080p",
  "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$1.18 / runOct 21, 2026
KwaiVGIVideo$8.46 / runOct 21, 2026
KwaiVGIVideo$1.18 / runOct 21, 2026
KwaiVGIVideo$1.18 / runOct 21, 2026
KwaiVGIVideo$2.10 / runOct 5, 2026
KwaiVGIVideo$2.10 / runOct 5, 2026

Questions

FAQ

How do I call KwaiVGI Kling V4 Reference to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "kwaivgi/kling-video/v4/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 V4 Reference to Video and the other models in the catalog; you do not need to sign up with KwaiVGI separately.