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
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
avatartakes a name or the exact{ "kind", "id" }selector. A name that matches several avatars needs the selector.- Leave out
voiceto use the avatar’s saved voice.mel audio voice listlists other voices. propstakes up to six images. Get asset IDs frommel uploadormel asset search.mel cast optionslists models, resolutions, aspect ratios and subtitle presets.mel cast templateslists 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.