Generate an AI motion clip
generate_motion_clipTurn a text-to-video prompt into ONE AI motion clip (Seedance 2.0 Mini). The prompt is sent EXACTLY as written: no script is written, no still images are made, no voice is added, nothing is rewritten or shortened. USE THIS TOOL when the user pastes or asks for a cinematic / video-model prompt (camera moves, lens, lighting, a scene description, "9:16 vertical", "slow dolly-in", the kind ChatGPT or Claude writes for Seedance, Sora or Veo). For a narrated story or facts video use create_video. The clip is silent (no audio, no lip-sync, no talking), 4-12 seconds (default 5), 480p. Price: 4 s = 92 credits, 5 s = 115, 12 s = 276; call quote_motion_clip first and tell the user the price before creating. These are the standard prices. A lower price applies for the credits bought in the last 31 days (an active paid plan period or a credit pack): the standard clip then costs 10 credits per second (5 s = 50). quote_motion_clip returns the exact price for THIS account. The credits are held when the clip is accepted and returned in full if no clip comes back. The only text added to the prompt is a short server suffix ("No spoken dialogue, no lip-sync, no talking to camera, no watermark."); the answer echoes promptSent and the seed so the user can see and repeat exactly what was made. Not accepted (CONTENT_POLICY, nothing charged): real or famous people, minors, sexual content, protected characters or brands, deepfakes and lip-sync. A first-frame photo is not supported. Optional templateId: one of the 26 ready clip templates from list_motion_templates; its prompt, seconds and aspect ratio are used. If you also pass prompt, the prompt wins and the template is ignored. An unknown templateId is refused (INVALID_INPUT, nothing charged). Any account with enough credits can use it: there is no plan or trial limit, too few credits is the only account refusal (INSUFFICIENT_CREDITS, nothing charged). At most 2 clips run at once; a daily capacity limit applies (DAILY_CAP_REACHED). Rendering is asynchronous: poll get_video every 20 seconds until COMPLETED (videoUrl is an MP4) or FAILED (errorCode, creditsRefunded). There are no webhooks. Pass idempotencyKey so a retry never charges twice. Requires the "video:create" scope. Optional tier: "seedance-2.5-480p" (Seedance 2.5 480p (with sound), 4-30 s, 68 credits per second: 5 s = 340, 15 s = 1020; 30 per second at the low price); "seedance-2.5-720p" (Seedance 2.5 720p (with sound), 4-30 s, 152 credits per second: 5 s = 760, 15 s = 2280; 66 per second at the low price); "wan-3.0-480p" (Wan 3.0 480p (with sound), 2-30 s, 33 credits per second: 5 s = 165, 15 s = 495; 15 per second at the low price); "wan-3.0-720p" (Wan 3.0 720p (with sound), 2-30 s, 66 credits per second: 5 s = 330, 15 s = 990; 29 per second at the low price); "wan-3.0-1080p" (Wan 3.0 1080p (with sound), 2-30 s, 131 credits per second: 5 s = 655, 15 s = 1965; 57 per second at the low price). A tier with sound returns the clip WITH an AI-generated sound track (speech, ambience) and the "no spoken dialogue" suffix is not added. Lip-sync, face swaps and talking avatars (a person talking to the camera) stay refused on every tier, with or without sound. A clip on an optional tier can take up to 30 minutes: keep polling, the credits stay held while it is being made. Without tier the clip is the standard silent one described above.
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_motion_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Optional. The answer always returns the seed used; pass it again to ask for a similar take (the provider treats it as best effort). | |
| tier | No | Optional. A higher-quality model with sound: seedance-2.5-480p = Seedance 2.5 480p (with sound); seedance-2.5-720p = Seedance 2.5 720p (with sound); wan-3.0-480p = Wan 3.0 480p (with sound); wan-3.0-720p = Wan 3.0 720p (with sound); wan-3.0-1080p = Wan 3.0 1080p (with sound). Omit it (or pass seedance-2.0-mini-480p) for the standard silent clip. A tier with sound costs more per second: quote it first. | |
| prompt | No | The video prompt, exactly as the user wrote or pasted it (8-2000 characters). Do not summarise, translate or "improve" it: it is sent to the video model unchanged. Required unless templateId is given. | |
| duration | No | Clip length in whole seconds (default 5). Up to 12 without tier; up to 30 with an optional tier. From 4 without tier; from 2 on a tier that makes shorter clips. | |
| templateId | No | Optional. The id of a motion clip template (list_motion_templates): its ready-made prompt is sent as written. Ignored when prompt is also given. | |
| aspect_ratio | No | Frame shape (default 9:16, vertical). | |
| idempotencyKey | No | Retry-safe: a repeat with the same key returns the first answer (replayed: true) and charges nothing. |