Skip to main content
POST
cURL

Usage notes

  • First frame: pass exactly one image in image_urls; last frames are not supported. The output aspect ratio follows the image.
  • Multi-shot: describe up to 6 shots in multi_prompt ({prompt, duration}, up to 512 characters each). Shot durations must add up to exactly duration (3-15 seconds). multi_shot is not accepted.
  • Audio: native audio is always generated; generate_audio: false is rejected.
  • Not supported: negative_prompt (write exclusions into the prompt), audio_urls, and video_url (use video_urls).

Billing

Billed per second of output video. The per-second rate depends on the resolution (720p or 1080p); native audio is always included. Current prices are shown on the model page.

Task flow

The create call returns data.task_id. Poll Query video task until status is completed (outputs in data.result) or failed, or pass callback_url to be notified when the task reaches a terminal state.

Authorizations

Authorization
string
header
required

Use your APIPod API key as a Bearer token in the Authorization header.

Body

application/json
model
string
required

Public APIPod model ID.

Allowed value: "kling-3.0-turbo-i2v"
image_urls
string[]
required

Exactly one first-frame image URL. Last frames are not supported. first_frame_image is accepted as an alias. The aspect ratio follows the image.

Required array length: 1 element
prompt
string

Text prompt describing the motion, up to 2,500 characters. Required unless multi_prompt is provided.

Maximum string length: 2500
duration
integer
default:5

Output duration in seconds (3-15). Defaults to 5. With multi_prompt, the shot durations must add up to exactly this value; when omitted it defaults to the sum of the shot durations.

Required range: 3 <= x <= 15
resolution
enum<string>
default:720p

Output resolution. Defaults to 720p. The per-second rate depends on the resolution.

Available options:
720p,
1080p
multi_prompt
Multi Prompt · object[]

Shot list for multi-shot generation, up to 6 shots. Each shot is {prompt, duration} with a prompt of up to 512 characters; the shot durations must add up to duration (3-15 seconds).

Maximum array length: 6
watermark
boolean
default:false

When true, an additional watermarked copy is generated and the watermarked copy is returned as the result.

callback_url
string
default:""

HTTPS URL that receives the task's terminal state.

Response

200 - application/json

Task accepted

Standard response for task submission

code
integer
required
data
Task Submit Data · object
required

Data content for task submission

message
string
required