Generate AI video
Generate a short clip from a prompt: one continuous camera move over one subject, silent unless you ask for audio, which costs more per second.
It is the most expensive asset there is, so the price per second is on GET /api/tools before you call. Output carries a SynthID watermark and needs an AI-generated label wherever the platform asks for one. The clip comes back as a media key ready to edit, caption or post.
Ask in plain words
- "generate a 5 second clip of rain on a window at night"
- "AI video generation API for short-form content"
- "make b-roll of a city at dusk with sound"
From an agent host (MCP)
Server: https://shapelessai.com/mcp (add it to your host).
generate_footage: Generate one short AI video clip from a prompt: one continuous camera move over one subject, silent unless with_audio (more per second). The dearest asset there is; try find_footage first. The clip carries a SynthID watermark and needs an AI-generated label where the platform asks. Returns a media key. SPENDS CREDIT: about $0.18 of engine cost a default call, billed with the plan's margin; budgetUsd caps it (default 2, max 10) and chargedUsd says what it cost. Needs the write scope.
From code (REST)
Bearer API key with the scope each call names (auth, OpenAPI).
POST /api/videos/generate(write scope): Generate AI footage (tool generate_footage): {name, prompt, duration_seconds?, aspect?, resolution?, with_audio?, budgetUsd?}.
The body
namestring, required: A 2-6 word filename for this clip, as you would describe it to a colleague - e.g. "rain on window neon". Becomes the file the user sees in their Assets.promptstring, required: The shot as 1-3 sentences of flowing prose: subject, setting, light, and the ONE camera move. Say what the camera does, not what the story means.duration_secondsnumber: 4, 6, 8 (6 by default); anything else rounds up, and you are billed for the rounded length. You pay per second, and you will cut most of it.aspectstring (9:16,16:9): Shape of the generated frame. 9:16 by default.resolutionstring (720p,1080p): 720p by default and right for b-roll under a cut. 1080p costs $0.05/s against $0.03/s - worth it only when the clip fills the frame and holds.with_audioboolean: Generate the clip's own sound too - $0.05/s at 720p against $0.03/s silent. Default false, because narration, music and sfx normally own the mix and a generated soundtrack fights them. Worth it when the clip sound IS the point: rain, a crowd, a machine, a diegetic moment that carries the shot. An unmuted clip is mixed into the master.budgetUsdnumber: The most this call may spend, in USD (default 2, max 10). Held while the tool runs, released after.
From a terminal (CLI)
shapeless tools run generate_footage --input '<json>'(tools show generate_footageprints the schema)
Example
Refusals
| Status | Meaning |
|---|---|
| 400 | The input does not match the tool's schema; the message names the field. |
| 402 | Not enough credit to hold budgetUsd, or the call costs more than budgetUsd. |
| 404 | No such tool on this deployment. |
| 422 | The tool refused this input; nothing was charged. |
| 502 | The tool failed; nothing was charged. |
Where else
More in Media
Generate an image · Edit a video · Record a product demo · Render a carousel · Render a thumbnail · Turn text into speech · Make subtitle files · Call any agent tool
