Kling V4 Reference to Video
kwaivgi/kling-video/v4/reference-to-videoKling 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
Try the model
Playground
PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 10
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
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Refer to inputs as @Image1, @Video1, … |
images | image URL[] | — | Up to 10 reference images. |
videos | video URL[] | — | Up to 5 reference videos, 3–30s each, 30s combined. |
aspect_ratio | auto / 16:9 / 9:16 / 1:1 / 21:9 | 16:9 | auto follows the references. |
resolution | 720p / 1080p | 1080p | Output resolution. |
duration | 3–30 | 5 | Output 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.
| Request | Price |
|---|---|
| 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.
# 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
| Model | Type | Default price | Released |
|---|---|---|---|
Kling V4 Reference to VideoThis model KwaiVGI | Video | $1.18 / run | Oct 21, 2026 |
KwaiVGI | Video | $8.46 / run | Oct 21, 2026 |
KwaiVGI | Video | $1.18 / run | Oct 21, 2026 |
KwaiVGI | Video | $1.18 / run | Oct 21, 2026 |
KwaiVGI | Video | $2.10 / run | Oct 5, 2026 |
KwaiVGI | Video | $2.10 / run | Oct 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.
