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.

Video
3s minimum, from 405 credits

Pricing

Generate audioCharge
Disabled / Not specified135 credits/second
Enabled168 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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.promptstring | unknownNoText prompt for video generation. Either prompt or multi_prompt must be provided, but not both.—
request_body.durationenum (3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15)NoVideo duration in seconds (3-15s).5
request_body.elementsarray | unknownNoElements (characters/objects) to include. Reference in prompt as @Element1, @Element2.—
request_body.elements[].voice_idstring | unknownNoThe 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_urlstring | unknownNoThe video URL of the element. A request can only have one element with a video.—
request_body.elements[].frontal_image_urlstring | unknownNoThe frontal image of the element (main view).—
request_body.elements[].reference_image_urlsarray | unknownNoAdditional reference images from different angles. 1-3 images supported. At least one image is required.—
request_body.shot_typestringNoThe type of multi-shot video generation.customize
request_body.image_urlsarray | unknownNoReference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 4 total (elements + reference images) when using video.—
request_body.aspect_ratioenum (16:9 | 9:16 | 1:1)NoThe aspect ratio of the generated video frame.16:9
request_body.multi_promptarray | unknownNoList of prompts for multi-shot video generation.—
request_body.multi_prompt[].promptstringYesThe prompt for this shot.—
request_body.multi_prompt[].durationenum (1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15)NoThe duration of this shot in seconds5
request_body.end_image_urlstring | unknownNoImage to use as the last frame of the video.—
request_body.generate_audiobooleanNoWhether to generate native audio for the video.false
request_body.start_image_urlstring | unknownNoImage 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-Key

Submit 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
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"
}