Generate videos

Generation modes

Set mode to choose a workflow. It defaults to text_to_video. Select a mode to update the example below.

Request example

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedance-2.5",
  "prompt": "A cinematic tracking shot along a coastal road at sunrise, warm backlight, gentle camera drift",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 8,
  "generate_audio": true,
  "route_mode": "official-cheap"
}'

Parameters

multi_ref needs at least one reference. Seedance 2.5 accepts up to 30 images, 10 videos, and 10 audio files (50 in total); the other models accept up to 9 images, 3 videos, and 3 audio files (12 in total). Use public https URLs, or upload files first with POST /v1/uploads.

Models

For Seedance, ratio, resolution, and duration are optional and fall back to each model's defaults.

Wan, HappyHorse, Grok Imagine, Kling, and MiniMax read the inputs rather than mode: send a start image as image_url, keyframes as first_frame_url and last_frame_url, and reference images, videos, and audio as image_urls, video_urls, and audio_urls. They are billed per second of output at the chosen resolution; Wan and MiniMax also bill the seconds of reference videos.

HappyHorse 1.0 Video Edit, Video Upscale, and Video Frame Interpolation take a source video as video_url, and the output is as long as the source. Video Upscale takes a target resolution; the two tools need no prompt.

Task lifecycle

Creating a video always returns HTTP 202 with a task. Save its id and poll poll_url. When status is succeeded, the response includes video, usage, and actual_charge_credits.

{
  "id": "task_01a9...",
  "object": "video.generation.task",
  "status": "queued",
  "created": 1767225600,
  "model": "bytedance/seedance-2.5",
  "api_method": "videos.generations.create",
  "poll_url": "/v1/videos/generations/task_01a9...",
  "progress": 0,
  "message": "queued",
  "estimated_charge_credits": 1.84
}

{
  "id": "task_01a9...",
  "object": "video.generation.task",
  "status": "succeeded",
  "progress": 100,
  "message": "completed",
  "video": "https://.../generated/01a9....mp4",
  "last_frame_image": "https://.../generated/01a9....jpg",
  "usage": {
    "output_tokens": 172800,
    "video_seconds": 8,
    "video_resolution": "720p"
  },
  "estimated_charge_credits": 1.84,
  "actual_charge_credits": 1.79
}

A failed task has status failed and the reason in message. Output URLs are hosted by MLMux; download the files you want to keep.

Webhooks