Kwaivgi Kling V3 Turbo Pro Image To Video
Playground
Try it on WavespeedAI!Kling V3 Turbo Pro converts first-frame images and optional prompts into high quality 1080P videos with fast pro-tier inference and multi-shot storyboard support. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Kling V3 Turbo Pro Image-to-Video
Kling V3 Turbo Pro Image-to-Video generates high quality 1080p videos from a first-frame reference image. It supports optional text guidance and multi-shot storyboard generation.
Why Choose This?
-
First-frame image animation
Turn a still image into a high quality video using the image as the starting frame. -
High quality 1080p output
Use the pro-tier model for stronger detail and visual quality. -
Optional prompt guidance
Add a prompt to guide motion, camera movement, and scene behavior. -
Multi-shot storyboard support
Usemulti_promptto define multiple prompted segments with separate durations. -
Standard video output
The generated video is returned as a URL in the standard WaveSpeed prediction response.
Parameters
| Parameter | Required | Description |
|---|---|---|
| image | Yes | First-frame reference image URL. JPG and PNG images work best. |
| prompt | No | Optional text prompt to guide the generated video. Mutually exclusive with multi_prompt. |
| multi_prompt | No | Multi-shot storyboard. Each item includes a prompt and duration. Mutually exclusive with prompt. |
| duration | No | Video duration in seconds for single-prompt generation. Options: 3 to 15. Default: 5. |
How to Use
- Upload an image — Provide the first-frame reference image.
- Enter a prompt (optional) — Describe the desired motion, camera movement, or scene change.
- Or create a storyboard — Use
multi_promptto define multiple prompted segments. - Set duration — Choose the video duration for single-prompt generation, or set durations per shot in
multi_prompt. - Submit — Generate the animated video output.
Output
Returns generated video URL(s) in the standard WaveSpeed prediction response.
The generated video is returned as MP4 video.
Pricing
Pricing is $0.14 per second.
WaveSpeed bills by the generated video duration. If multi_prompt is provided, billing uses the selected duration plus the sum of all segment durations.
| Generated Duration | Price |
|---|---|
| 3s | $0.42 |
| 5s | $0.70 |
| 10s | $1.40 |
| 15s | $2.10 |
Billing Rules
- Billing is based on generated video duration.
- Single-prompt requests use the
durationparameter. multi_promptrequests usedurationplus the sum of all segment durations.- Each second costs $0.14.
Best Use Cases
- Image animation — Animate still images into short video clips.
- Product motion concepts — Create motion previews from product or object images.
- Character and scene animation — Add movement to portraits, scenes, or illustrated frames.
- Storyboard generation — Build multi-shot videos from one starting image.
- Creative video prototyping — Quickly test image-driven video directions.
Pro Tips
- Use a sharp, high quality image with a clear subject.
- Add motion and camera details in the prompt for stronger control.
- Use
multi_promptwhen you want multiple guided segments. - Keep total
multi_promptduration within the model limit. - Make sure the image URL is publicly accessible.
Notes
imageis required.promptis optional.promptandmulti_promptare mutually exclusive.durationis used for single-prompt generation.multi_promptsupports per-shot durations.- The total generated duration must not exceed 15 seconds.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/kwaivgi/kling-v3-turbo-pro/image-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"duration": "5"
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| image | string | Yes | - | First-frame reference image. Supported formats: .jpg/.jpeg/.png; max 50MB; min 300px per side; aspect ratio within 1:2.5 to 2.5:1. | |
| prompt | string | No | - | Optional text prompt to guide the video. Mutually exclusive with multi_prompt. | |
| multi_prompt | array | No | - | - | Multi-shot storyboard. Each shot has its own prompt and duration; total duration must not exceed 15 seconds. Mutually exclusive with prompt. |
| duration | string | No | 5 | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | Video length in seconds. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |