muapi CLI

Official command-line interface for muapi.ai — generate images, videos, and audio directly from your terminal.

Agent-first design — every command works for both humans (colored output, tables) and AI agents (--output-json, --jq filtering, semantic exit codes, MCP server mode).

Related Projects

• MuAPI CLI docs — Command reference and setup guidance.
• MuAPI API reference — Underlying endpoints and prediction lifecycle.
• MiniMax-H3-API — Python SDK for MiniMax H3 video-generation workflows on Muapi.
• awesome-minimax-h3-prompts — Prompt gallery with runnable MiniMax H3 examples for the CLI.
• Wan-3.0-API — Python SDK and MCP server for Wan 3.0-compatible AI video generation.
• Open-Generative-AI — Browser-based GUI for the same models — no CLI required
• Awesome-GPT-Image-2-API-Prompts — Curated prompt library to run via this CLI
• ai-creator-academy — free curriculum teaching creators how to monetize generative AI, including running models via this CLI
• Flux-3-Dev-API — Python wrapper for Black Forest Labs' FLUX 3 (Dev variant) — text-to-image, image-to-image, text-to-video, image-to-video
• Grok-Imagine-Image-2-API — Python SDK and MCP server for Grok Imagine Image 2.0 generation and editing through MuAPI
• awesome-flux-3-api-prompts — FLUX 3 API guide, prompts, and parameters
• flux-3-video-api — Python wrapper focused on FLUX 3 Text-to-Video and Image-to-Video
• seedance-2.5-mcp — MCP server for generating Seedance 2.5 Preview videos through MuAPI.
• seedance-2-mcp — MCP server for generating Seedance 2 videos through MuAPI.

Install

# npm (recommended — no Python required)
npm install -g muapi-cli

# pip
pip install muapi-cli

# or run without installing
npx muapi-cli --help

Quick Start

# New user? Create an account
muapi auth register --email you@example.com --password "..."
muapi auth verify --email you@example.com --otp 123456
muapi auth login --email you@example.com --password "..."

# Or paste an existing API key
muapi auth configure --api-key "YOUR_KEY"

# Generate — pick a curated verb…
muapi image generate "a cyberpunk city at night" --model flux-dev
muapi video generate "a dog running on a beach" --model kling-master
muapi audio create "upbeat lo-fi hip hop for studying"

# …or run any model by endpoint name (schema-driven, covers the whole catalog)
muapi run flux-dev-image -p "a cyberpunk city at night"
muapi run seedance-2-text-to-video -p "drone shot over snowy peaks" -i duration=5
muapi run <model> -h          # introspects the live OpenAPI schema

# Check balance
muapi account balance

# Wait for an existing job
muapi predict wait <request_id>

Commands

muapi auth

| Command | Description | |---------|-------------| | muapi auth register --email x --password y | Create a new account (sends OTP) | | muapi auth verify --email x --otp 123456 | Verify email after registration | | muapi auth login --email x --password y | Log in and save API key automatically | | muapi auth forgot-password --email x | Send password reset OTP | | muapi auth reset-password --email x --otp y --password z | Reset password | | muapi auth configure | Manually save an API key | | muapi auth whoami | Show current API key (masked) | | muapi auth logout | Remove stored API key |

muapi account

| Command | Description | |---------|-------------| | muapi account balance | Show current credit balance | | muapi account topup --amount 20 | Add credits via Stripe checkout |

muapi keys

| Command | Description | |---------|-------------| | muapi keys list | List all API keys on your account | | muapi keys create --name label | Create a new API key (shown once) | | muapi keys delete <id> | Delete an API key by ID |

muapi image

| Command | Description | |---------|-------------| | muapi image generate <prompt> | Text-to-image generation | | muapi image edit <prompt> --image <url> | Image-to-image editing | | muapi image models | List available models |

Models: flux-dev, flux-schnell, flux-kontext-dev/pro/max, hidream-fast/dev/full, wan2.1, reve, gpt4o, midjourney, seedream, qwen

muapi video

| Command | Description | |---------|-------------| | muapi video generate <prompt> | Text-to-video generation | | muapi video from-image <prompt> --image <url> | Image-to-video animation | | muapi video models | List available models |

Models: veo3, veo3-fast, kling-master, kling-std, kling-pro, wan2.1/2.2, seedance-pro/lite, hunyuan, runway, pixverse, vidu, minimax-std/pro

muapi audio

| Command | Description | |---------|-------------| | muapi audio create <prompt> | Create music with Suno | | muapi audio remix <song-id> | Remix an existing Suno song | | muapi audio extend <song-id> | Extend a Suno song | | muapi audio from-text <prompt> | Generate audio with MMAudio | | muapi audio from-video <video-url> | Add AI audio to a video |

muapi enhance

| Command | Description | |---------|-------------| | muapi enhance upscale <url> | AI image upscaling | | muapi enhance bg-remove <url> | Remove background | | muapi enhance face-swap --source <url> --target <url> | Face swap image/video | | muapi enhance skin <url> | Skin enhancement | | muapi enhance colorize <url> | Colorize B&W photo | | muapi enhance ghibli <url> | Ghibli anime style | | muapi enhance anime <url> | Anime style conversion | | muapi enhance extend <url> | Outpaint/extend image | | muapi enhance product-shot <url> | Professional product photo | | muapi enhance erase <url> --mask <url> | Object removal |

muapi edit

| Command | Description | |---------|-------------| | muapi edit effects --video <url> --effect <name> | AI video/image effects | | muapi edit lipsync --video <url> --audio <url> | Lip sync to audio | | muapi edit dance --image <url> --video <url> | Make person dance | | muapi edit dress --image <url> | Change clothing | | muapi edit clipping <video-url> | AI highlight extraction |

muapi run — generic, schema-driven runner

Reaches any model in the muapi.ai catalog by endpoint name, even ones not covered by the curated image / video / audio / enhance / edit verbs. The input schema is fetched from the live OpenAPI spec, so muapi run <model> -h always reflects the real, current parameters.

| Command | Description | |---------|-------------| | muapi run <model> -h | Print model-specific inputs from the live OpenAPI schema | | muapi run <model> -p "..." | Run with a prompt | | muapi run <model> -p "..." -i k=v -i k=v | Pass arbitrary inputs (JSON-parsed when valid) | | muapi run <model> --input-file inputs.json | Inputs from a JSON file | | muapi run <model> ... --dry-run | Show the request body without sending |

<model> accepts either a real endpoint slug (flux-dev-image, nano-banana-2, seedance-2-text-to-video) or a short alias from the curated tables (flux-dev, seedream, kling-master).

Merge order for inputs (later wins): --input-file → -i k=v → -p prompt.

# Discover a model's real inputs
muapi run nano-banana-2 -h

# Run it
muapi run nano-banana-2 -p "a logo for a coffee shop" -i num_images=2 --download ./out

# Pipe-safe JSON
muapi run flux-dev-image -p "..." --output-json --jq '.outputs[0]'

muapi predict

| Command | Description | |---------|-------------| | muapi predict result <id> | Fetch current status (no polling) | | muapi predict wait <id> | Wait until complete |

muapi upload

| Command | Description | |---------|-------------| | muapi upload file <path> | Upload a local file → get hosted URL |

muapi models

| Command | Description | |---------|-------------| | muapi models list | List all models | | muapi models list --category video | Filter by category |

muapi config

| Command | Description | |---------|-------------| | muapi config set <key> <value> | Set a persistent default | | muapi config get <key> | Read a config value | | muapi config list | Show all config |

Useful keys: output (json/human), model.image, model.video, no_color (true/false)

muapi docs

| Command | Description | |---------|-------------| | muapi docs openapi | Fetch the full OpenAPI spec | | muapi docs open | Open Swagger UI in browser |

muapi mcp

| Command | Description | |---------|-------------| | muapi mcp serve | Start MCP server (stdio) for AI agents |

Global Options

| Flag | Description | |------|-------------| | --wait / --no-wait | Poll until done (default: --wait) | | --output-json / -j | Print raw JSON response | | --jq <expr> | Filter JSON output