Skip to content
ShapelessAI← Back
Media

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.

View as Markdown

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

  • name string, 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.
  • prompt string, 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_seconds number: 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.
  • aspect string (9:16, 16:9): Shape of the generated frame. 9:16 by default.
  • resolution string (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_audio boolean: 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.
  • budgetUsd number: 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_footage prints the schema)

Example

curl -s https://shapelessai.com/api/videos/generate -H "Authorization: Bearer $SHAPELESS_API_KEY" -H "Content-Type: application/json" -d '{"name":"rain window","prompt":"Slow push-in on rain hitting a window at night, neon bleeding through."}'

Refusals

StatusMeaning
400The input does not match the tool's schema; the message names the field.
402Not enough credit to hold budgetUsd, or the call costs more than budgetUsd.
404No such tool on this deployment.
422The tool refused this input; nothing was charged.
502The 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

Every capability · Docs · /llms.txt