Skip to main content
POST
cURL
muse-video-t2v turns a written prompt into a finished clip. There is no source media to prepare — you describe the shot and Muse Video handles motion, lighting and style, and generates synchronized voice and sound alongside the picture.

Model at a glance

Parameters

negative_prompt, seed and reference media are not supported on this model — use muse-video-i2v or muse-video-r2v when you need to guide the picture with images.

Style presets

Prompting

Muse Video follows camera language closely. A prompt that names the shot, the light and one or two materials produces noticeably more controlled results than a stack of adjectives.
That prompt fixes three things the model would otherwise guess: framing (low-angle tracking shot), light (backlit spray, warm highlights) and pace (cinematic slow motion). Materials and subject stay short so nothing competes for attention. Keep prompts under roughly 400 characters for the most reliable prompt adherence; the 4000-character limit exists for structured briefs and multi-shot descriptions.

Workflow

  1. POST /v1/videos/generations with the parameters above.
  2. Read data.task_id from the response.
  3. Poll GET /v1/videos/status/{task_id} every few seconds until status is completed.
  4. Download from data.result.
A 5-second clip typically returns in one to three minutes; 60-second clips can take considerably longer. Poll until the task reaches a terminal state rather than assuming a fixed wait.

Cost

Billing is per output second: duration × per-second price. Because text-to-video has no reference media, the charge is fully determined by the duration you send — quote it with POST /v1/pricing/estimate before submitting a batch.

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: "muse-video-t2v"
prompt
string
required

Describe the video to generate. Required, up to 4000 characters.

Required string length: 1 - 4000
duration
enum<integer>
default:5

Video duration in seconds.

Available options:
5,
10,
20,
30,
40,
50,
60
aspect_ratio
enum<string>
default:16:9

Aspect ratio of the generated video.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4
resolution
enum<string>
default:720p

Output resolution. MU Video currently supports 720p only.

Available options:
720p
style_preset
enum<string>
default:none

Visual style preset applied to the video.

Available options:
none,
cinematic_realistic,
2d_anime,
3d_xianxia,
american_comic,
cyberpunk_neon,
ecommerce_ugc
generate_audio
boolean
default:true

Whether to generate voice and sound. Set to false to mute voices.

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