Generate clip
generate_clipStart a short video clip generation. This spends credits, or runs on the user's own key (get_credits), and returns immediately.
Search list_recipes and read promising matches with get_recipe before choosing a model. Prefer a close-fitting recipe through generate_with_recipe; use this direct tool when none fits, with parameters from the chosen model's guide.
Presets add Style, Motion, Lighting and Framing through the presets map. Name the account's Subjects in subjects — the server seats each one's face.
Several models require a reference image, video or audio track — list_models has each model's durations, resolutions and required_inputs; create_upload, import_media or request_upload_link bring media in.
One call is one shot. Longer motion: carry the last frame into the next call (extract_video_frame), then join_clips. Speech is the exception: each line of at most 15 seconds starts from the same portrait, never a chained frame.
Models (credits for 5s at 720p):
seedance-2.5: ~96.5
seedance-2.0: ~75
seedance-2.0-fast: ~62.5
seedance-2.0-mini: ~37.5
grok-imagine-video-1.5: ~33.5, needs image
veo-3.1: ~83.5
veo-3.1-fast: ~42
veo-3.1-lite: ~21
gemini-omni-1.1: ~62.5, length set by input
kling-v3-omni-video: ~70
kling-v3-video: ~70
happyhorse-1.0: ~58.5
wan-3: ~42
wan-3-prime: ~58.5
gen-4.5: ~50
p-video: ~8.5
p-video-2: ~12.5
flux-3: ~71
minimax-h3-max: ~33.5
p-video-avatar: ~10.5, needs image+audio, length set by input
p-video-animate: ~12.5, needs image+video, length set by input
p-video-replace: ~12.5, needs image+video, length set by input
omni-human-1.5: ~67, needs image+audio, length set by input
kling-avatar-v2: ~22, needs image+audio, length set by input
kling-v3-motion-control: ~29.5, needs image+video, length set by input
sync-lipsync-2: ~21, needs video+audio, length set by input
kling-lip-sync: ~6, needs video, length set by input …and 2 more; list_models has every model.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "generate_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| prompt | No | ||
| presets | No | ||
| runs_on | No | Who pays: "credits", or one of the user's own keys by vendor (get_credits lists them). Leave out to follow their payer order; set it only when the user chose. | |
| subjects | No | Names or ids of the account's Subjects (list_subjects). The server supplies each one's face and description — seated against the model's capacity — so do not also attach pictures of them. | |
| last_frame | No | ||
| resolution | No | ||
| first_frame | No | ||
| recreate_of | No | ||
| aspect_ratio | No | Defaults to 9:16 (vertical). Confirm the shape with the user when the destination is unclear — a feed, a banner and a phone screen want different ones. With a first frame, leave it out: the clip takes the frame's own shape, and a ratio that disagrees with the frame is refused. | |
| generate_audio | No | ||
| idempotency_key | No | Optional. Pass the same value to retry one operation without spending twice; omit it for a new operation. Different arguments under a reused key are refused. | |
| duration_seconds | No | ||
| reference_audios | No | ||
| reference_images | No | ||
| reference_videos | No | The video this clip is driven by — a source performance to copy, or the take a mouth is re-synced in. Uploads and clips you generated alike, in the shape list_media returns. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | ||
| generation | Yes | One image, clip, voice-over or piece of music. |