Kling Video O3 Pro Reference To Video
3s minimum, from 405 credits
ae_kling_video_o3_pro_reference_to_video
Create a short video from a prompt, using reference images, start or end frames, and consistent characters or objects. You can also create multiple shots and generate audio.
3s minimum, from 405 credits
Pricing
| Generate audio | Charge |
|---|---|
| Disabled / Not specified | 135 credits/second |
| Enabled | 168 credits/second |
An omitted duration is charged as one second. Starting price applies to Generate audio: Disabled.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.prompt | string | unknown | No | Text prompt for video generation. Either prompt or multi_prompt must be provided, but not both. | — |
request_body.duration | enum (3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15) | No | Video duration in seconds (3-15s). | 5 |
request_body.elements | array | unknown | No | Elements (characters/objects) to include. Reference in prompt as @Element1, @Element2. | — |
request_body.elements[].voice_id | string | unknown | No | The voice ID for this element. The voice will be binded to the element and references to this element will use the binded voice. Voice binding is only supported for video elements, and cannot be used with image elements. Get voice IDs from the following endpoint: https://fal.ai/models/fal-ai/kling-video/create-voice | — |
request_body.elements[].video_url | string | unknown | No | The video URL of the element. A request can only have one element with a video. | — |
request_body.elements[].frontal_image_url | string | unknown | No | The frontal image of the element (main view). | — |
request_body.elements[].reference_image_urls | array | unknown | No | Additional reference images from different angles. 1-3 images supported. At least one image is required. | — |
request_body.shot_type | string | No | The type of multi-shot video generation. | customize |
request_body.image_urls | array | unknown | No | Reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video. | — |
request_body.aspect_ratio | enum (16:9 | 9:16 | 1:1) | No | The aspect ratio of the generated video frame. | 16:9 |
request_body.multi_prompt | array | unknown | No | List of prompts for multi-shot video generation. | — |
request_body.multi_prompt[].prompt | string | Yes | The prompt for this shot. | — |
request_body.multi_prompt[].duration | enum (1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15) | No | The duration of this shot in seconds | 5 |
request_body.end_image_url | string | unknown | No | Image to use as the last frame of the video. | — |
request_body.generate_audio | boolean | No | Whether to generate native audio for the video. | false |
request_body.start_image_url | string | unknown | No | Image to use as the first frame of the video. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeySubmit first, then query with the returned task_id until the task completes.
Request coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_kling_video_o3_pro_reference_to_video' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"aspect_ratio": "16:9",
"duration": "5",
"generate_audio": false,
"prompt": "破晓云海之上的巨大青玉莲花,圆形莲台之上有修士打坐,身姿静止,衣袍与发丝在微风中极轻浮动,莲花瓣上的水珠缓缓滴落,空中灵珠缓慢上升,云海轻柔流动,花瓣随晨光微微舒展,镜头从莲台近景缓慢拉远,逐步展现整朵莲花与两侧远山,青玉花瓣纹理与金色脉络清晰,晨光通透柔和,水滴反光自然,物理真实,电影级运镜"
}
}
}'Response exampleresponse.json
{
"description": "task accepted; poll the result via query_tool with this task_id",
"query_tool": "ae_get_result",
"status": "created",
"task_id": "33fdae13-f2f4-4d2d-826c-513094c4bbad"
}



