Skip to main content

1. Install and authenticate

Don’t have a key yet? Create one in the app under Team settings → Integrations. See Installation for details.

2. Generate your first image

These commands create a project and canvas, add an image node with your prompt, run it, wait for the generation to finish, and print the URL of the result.
No model is specified, so Melius picks one for you. To choose one, add --model <name> --variant <variant> (discover options with mel model list --category image).
Every create command returns the created object as JSON. --fields id --text prints just the id so you can capture it in a shell variable — drop those flags to see the full object.

3. Or build a whole pipeline in one call

mel node bulk-create creates multiple nodes and the edges between them at once — ideal for a text-to-image pipeline:
mel bulk-run executes nodes tier by tier — downstream nodes wait for their inputs to finish.

Generate video, too

Everything works the same for video — use --type video and a --duration in seconds:
Discover video models and their options with mel model list --category video.

4. Read the result

mel canvas content is the primary read command — it returns the live canvas state (nodes, edges, and generated outputs).

Next steps

Command reference

Every command, flag, exit code, and error shape.

Using mel from an agent

JSON parsing, exit-code branching, and headless auth.
Last modified on July 1, 2026