Skip to main content
mel cast makes a video of a saved avatar speaking your script. It runs the same Cast as Melius, charges your team’s credits, and puts finished videos in Cast’s History. The command reference lists every command. Prepare checks the request and estimates credits without generating, run starts the paid video, and wait blocks until it’s done.

1. Find an avatar

Each result has an avatar selector ({ "kind", "id" }) and a name. Use --roster melius for Melius avatars, and --kind background for saved backgrounds.

2. Write the request

Save the request as JSON. sections is the script: 1–30 sections, each with spoken text and an optional silent action.
request.json
  • avatar takes a name or the exact { "kind", "id" } selector. A name that matches several avatars needs the selector.
  • Leave out voice to use the avatar’s saved voice. mel audio voice list lists other voices.
  • props takes up to six images. Get asset IDs from mel upload or mel asset search.
  • mel cast options lists models, resolutions, aspect ratios and subtitle presets.
  • mel cast templates lists script templates to start from.

3. Prepare, run and wait

prepare returns status: "ready" with estimatedCredits, or invalid with a validationError. Only a ready preparation can run. Keep prepared.json: if you lose the response from mel cast run, run the same file again to get the same video back instead of starting another. mel cast wait stops waiting after 60 seconds at most (--timeout) with exit code 4, and the video keeps rendering. Run wait again with the same ID to keep waiting.
Last modified on November 16, 2026