Melies CLI - AI Agent Creative Toolkit

150 AI actors. 220+ visual styles. 50+ models. Zero prompt engineering.
Generate images, videos, movie posters, and YouTube thumbnails from the command line.

     

   

---

Quick Start

npm install -g melies

Then authenticate:

# Browser login (opens melies.co, authenticates automatically)
melies login

# Or use an API token directly (for CI/agents)
melies login --token YOUR_TOKEN

# Or set as environment variable
export MELIES_TOKEN=your_token

Generate an API token at melies.co > Settings > API.

Start generating:

melies image "portrait in a café" --actor mei --art-style ghibli --lighting golden --sync

---

What It Does

• 150+ AI actors with identity consistency across every generation
• 220+ visual styles covering art styles, lighting, camera angles, expressions, moods, color grades, eras, and more
• 50+ AI models from Flux, Kling, Veo, Runway, Luma, Hailuo, Seedance, Wan, and others
• Image → Video pipeline in a single command (generates image, then animates it)
• Movie posters with title, credits, cast, and 20 style presets
• YouTube thumbnails with batch generation (up to 4 variations)
• Upscale and background removal powered by AI
• Built for AI agents with structured JSON output, SKILL.md auto-discovery, and predictable flags
• Smart model selection with --fast, --quality, and --best presets (no need to memorize model names)

---

Examples

Generate an image with an AI actor

melies image "cinematic portrait in golden hour" --actor mei --art-style ghibli --lighting golden --sync

Generate a movie poster

melies poster "Midnight Protocol" --actor dante --actor elena --style anime --sync

Image → Video pipeline in one command

melies pipeline "tracking shot through neon Tokyo" --actor hailey --best --sync

Generate 4 YouTube thumbnails

melies thumbnail "shocked face reacting to AI news" --actor aria -n 4 --sync

Preview cost before generating

melies image "sunset" --quality --actor hailey --dry-run

---

Visual Style Flags

Combine freely on any image, video, thumbnail, or pipeline command. Browse all styles.

Flag	Examples
--art-style	ghibli, anime, noir, oil, watercolor, concept
--lighting	golden, neon, noir, rembrandt, backlit, soft
--camera	eye-level, high, low, overhead, dutch
--shot	close-up, medium, cowboy, wide, full-body
--expression	smile, surprised, serious, villain-smirk
--mood	romantic, mysterious, tense, ethereal, epic
--color-grade	teal-orange, mono, warm, cool, filmic
--era	victorian, 1920s, 1980s, modern, dystopian

Plus: --time, --weather, --composition, --dof, --focal-length, --aperture, --lens, --exposure, --camera-model, --movement

melies image "woman in a café" --lighting golden --mood romantic --art-style ghibli --era 1920s --sync

---

Smart Model Selection

Use quality presets instead of model names:

Preset	Image Model	Image Cost	Video Model	Video Cost
--fast (default)	flux-schnell	2 cr	kling-v2	30 cr
--quality	flux-pro	8 cr	kling-v3-pro	100 cr
--best	seedream-3	6 cr	veo-3.1	400 cr

Override with -m <model>. Run melies models or browse all models.

---

AI Actors

148 built-in characters with identity consistency across every generation. Browse all actors.

melies actors                              # List all actors
melies actors --gender female --age 20s    # Filter
melies actors search "asian"               # Search

# Create a custom actor from any face
melies ref create "jean-pierre" -i photo.jpg

---

All Commands

Command	Description
melies image	Generate images from text prompts
melies video	Generate videos from text or image prompts
melies pipeline	Image → Video in one command
melies poster	Movie posters with title, credits, and cast
melies thumbnail	YouTube thumbnails with batch generation
melies upscale	AI image upscaling
melies remove-bg	Background removal
melies actors	Browse 150+ AI actors
melies styles	Browse 220+ visual styles
melies credits	Check your credit balance
melies models	List all available models
melies status	Check generation status
melies assets	List your generated assets
melies login	Authenticate (browser or token)

---

For AI Agents

Melies is built for AI agents. Generation commands always output JSON. Browse commands (credits, models, actors, assets, styles) show tables by default. Use --json to get structured JSON output for parsing. The CLI ships with a SKILL.md file that any agent can read for auto-discovery.

Works with: Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, Codex, Gemini, Goose, Amp, Trae, Vibe, Replit, OpenCode, Manus, and any agent that reads SKILL.md.

# Token auth for CI/agents
melies login --token YOUR_TOKEN

# Or set as environment variable
export MELIES_TOKEN=your_token

See the Agent Documentation for integration patterns and best practices.

---

Powered by 50+ AI Models

Flux, Kling, Veo, Runway, Luma, Hailuo, Seedance, Wan, LTX, ElevenLabs, xAI Grok, ByteDance, Meta, and more. New models added regularly.

---

Links

• Website
• Agent Page
• Documentation
• Browse AI Actors
• Browse Visual Styles
• Browse AI Models
• agentskill.sh
• ClawHub

License

MIT