Model API
Kling 4.0
Kling 4.0 animates a starting image into a 3 to 30-second video at 720p or 1080p, with optional ending frames and per-shot prompts.
Model id
kling/v4/image-to-videoThis model has other modes with their own ids: kling/v4/text-to-video, kling/v4/reference-to-video, kling/v4/video-to-video/edit.
Run it
Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.
# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
-H "Authorization: Bearer $RAYWAKE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling/v4/image-to-video",
"input": {
"prompt": "A red ceramic cup on a wooden table, soft morning light",
"start_image_url": "https://example.com/input.png"
}
}'
# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
-H "Authorization: Bearer $RAYWAKE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"model": "kling/v4/image-to-video", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","start_image_url":"https://example.com/input.png"}}'
# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
-H "Authorization: Bearer $RAYWAKE_API_KEY"Input
| Name | Type | Description |
|---|---|---|
prompt | string | Text prompt. Either prompt or multi_prompt must be provided. |
start_image_urlrequired | string (image URL) | Image to use as the first frame of the video. Max file size: 30.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s |
end_image_url | string (image URL) | Image to use as the last frame of the video. |
multi_prompt | array of objects | Per-shot prompts for multi-shot generation. The video duration is the sum of the shot durations. |
duration | integer | Video duration in seconds (3-30). |
resolution | string (enum) | Output resolution. |
Output
A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.
"outputs": [
{ "type": "video", "url": "https://…", "mime_type": "video/mp4", "thumbnail_url": "https://…" }
]Pricing
- 720p$0.2488/ second
- 1080p$0.3724/ second
The exact charge for your input comes from a quote. How charges settle