muapi CLI

muapi.ai 的官方命令行界面——直接在终端生成图像、视频和音频。

以代理优先的设计——每个命令都适用于人类（彩色输出、表格）和 AI 代理（--output-json、--jq 过滤、语义退出码、MCP 服务器模式）。

安装

# npm（推荐——无需 Python）
npm install -g muapi-cli

# pip
pip install muapi-cli

# 或者无需安装直接运行
npx muapi-cli --help

快速入门

# 新用户？创建账户
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 "..."

# 或者粘贴现有 API 密钥
muapi auth configure --api-key "YOUR_KEY"

# 生成
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"

# 查询余额
muapi account balance

# 等待现有任务完成
muapi predict wait <request_id>

命令

muapi auth

命令	描述
muapi auth register --email x --password y	创建新账户（发送 OTP）
muapi auth verify --email x --otp 123456	注册后验证邮箱
muapi auth login --email x --password y	登录并自动保存 API 密钥
muapi auth forgot-password --email x	发送密码重置 OTP
muapi auth reset-password --email x --otp y --password z	重置密码
muapi auth configure	手动保存 API 密钥
muapi auth whoami	显示当前 API 密钥（已遮掩）
muapi auth logout	移除存储的 API 密钥

muapi account

命令	描述
muapi account balance	显示当前信用余额
muapi account topup --amount 20	通过 Stripe 支付添加信用

muapi keys

命令	描述
muapi keys list	列出您账户上的所有 API 密钥
muapi keys create --name label	创建新的 API 密钥（仅显示一次）
muapi keys delete <id>	根据 ID 删除 API 密钥

muapi image

命令	描述
muapi image generate <prompt>	文本到图像生成
muapi image edit <prompt> --image <url>	图像到图像编辑
muapi image models	列出可用模型

模型： flux-dev、flux-schnell、flux-kontext-dev/pro/max、hidream-fast/dev/full、wan2.1、reve、gpt4o、midjourney、seedream、qwen

muapi video

命令	描述
muapi video generate <prompt>	文本到视频生成
muapi video from-image <prompt> --image <url>	图像到视频动画
muapi video 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

命令	描述
muapi audio create <prompt>	使用 Suno 创作音乐
muapi audio remix <song-id>	翻新现有 Suno 歌曲
muapi audio extend <song-id>	延长 Suno 歌曲
muapi audio from-text <prompt>	使用 MMAudio 生成音频
muapi audio from-video <video-url>	为视频添加 AI 音频

muapi enhance

命令	描述
muapi enhance upscale <url>	AI 图像超分辨率
muapi enhance bg-remove <url>	移除背景
muapi enhance face-swap --source <url> --target <url>	图像/视频换脸
muapi enhance skin <url>	美颜处理
muapi enhance colorize <url>	黑白照片上色
muapi enhance ghibli <url>	吉卜力动画风格
muapi enhance anime <url>	动画风格转换
muapi enhance extend <url>	图像扩展/补画
muapi enhance product-shot <url>	专业产品摄影
muapi enhance erase <url> --mask <url>	物体移除

muapi edit

命令	描述
muapi edit effects --video <url> --effect <name>	AI 视频/图像特效
muapi edit lipsync --video <url> --audio <url>	配音同步
muapi edit dance --image <url> --video <url>	让人物跳舞
muapi edit dress --image <url>	更换服装
muapi edit clipping <video-url>	AI 高亮提取

muapi predict

命令	描述
muapi predict result <id>	获取当前状态（无需轮询）
muapi predict wait <id>	等待任务完成

muapi upload

命令	描述
muapi upload file <path>	上传本地文件 → 获取托管 URL

muapi models

命令	描述
muapi models list	列出所有模型
muapi models list --category video	按类别筛选

muapi config

命令	描述
muapi config set <key> <value>	设置持久默认值
muapi config get <key>	读取配置值
muapi config list	显示所有配置

常用键： output（json/human）、model.image、model.video、no_color（true/false）

muapi docs

命令	描述
muapi docs openapi	获取完整的 OpenAPI 规范
muapi docs open	在浏览器中打开 Swagger UI

muapi mcp

命令	描述
muapi mcp serve	启动 MCP 服务器（stdio），供 AI 代理使用

全局选项

标志	描述
--wait / --no-wait	轮询直至完成（默认：--wait）
--output-json / -j	打印原始 JSON 响应
--jq <expr>	过滤 JSON 输出（例如 '.outputs[0]'）
--download <dir> / -d	自动将输出下载到指定目录
--no-color	禁用彩色输出

环境变量

变量	描述
MUAPI_API_KEY	API 密钥（覆盖密钥链/配置）
MUAPI_BASE_URL	覆盖 API 基础 URL
NO_COLOR	禁用彩色输出

退出码

代码	含义
0	成功
1	通用错误
3	认证错误
4	速率限制
5	未找到
6	计费错误
7	超时
8	验证错误

MCP 服务器

作为 Claude Desktop、Cursor 或任何兼容 MCP 的智能体的模型上下文协议服务器运行：

muapi mcp serve

Claude Desktop 配置（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "muapi": {
      "command": "muapi",
      "args": ["mcp", "serve"],
      "env": { "MUAPI_API_KEY": "your-key-here" }
    }
  }
}

公开 19 个工具：图像生成/编辑、视频生成/基于图像生成、音频创建/从文本生成、增强（放大/去除背景/人脸互换/吉卜力风格）、唇形同步/剪辑编辑、结果预测、文件上传、密钥列表/创建/删除、账户余额/充值。

智能体流程示例

# 完全自动化注册流程，无需人工干预
muapi auth register --email agent@example.com --password "secret"
muapi auth verify --email agent@example.com --otp 123456
muapi auth login --email agent@example.com --password "secret"
muapi account balance --output-json
muapi account topup --amount 10 --output-json --no-open

# 异步提交任务，获取 request_id，待完成后再轮询
REQUEST_ID=$(muapi video generate "a dog on a beach" \
  --model kling-master --no-wait --output-json --jq '.request_id' | tr -d '"')
muapi predict wait "$REQUEST_ID" --download ./outputs

# 链式操作：上传 → 编辑 → 下载
URL=$(muapi upload file ./photo.jpg --output-json --jq '.url' | tr -d '"')
muapi image edit "make it look like a painting" --image "$URL" \
  --model flux-kontext-pro --download ./outputs

# 以编程方式轮换 API 密钥
NEW_KEY=$(muapi keys create --name "ci-$(date +%Y%m%d)" --output-json --jq '.api_key' | tr -d '"')
OLD_ID=$(muapi keys list --output-json --jq '.[0].id')
muapi keys delete "$OLD_ID" --yes

# 发现可用的 API 端点
muapi docs openapi --jq '.paths | keys[]'

Shell 自动补全

muapi --install-completion bash
muapi --install-completion zsh
muapi --install-completion fish

muapi-cli 快速上手指南

muapi-cli 是 muapi.ai 的官方命令行工具，支持在终端直接生成图像、视频和音频。其设计兼顾人类用户（彩色输出、表格）与 AI 智能体（JSON 输出、语义退出码、MCP 模式）。

环境准备

• 操作系统：支持 macOS、Linux 及 Windows (WSL)。
• 前置依赖：
  • 推荐方式：需安装 Node.js (包含 npm 或 npx)，无需 Python 环境。
  • 备选方式：需安装 Python 3.x 及 pip。
• 网络要求：需能访问 muapi.ai 服务。

安装步骤

推荐使用 npm 进行全局安装，无需配置 Python 环境：

# 方式一：通过 npm 全局安装（推荐）
npm install -g muapi-cli

# 方式二：通过 pip 安装
pip install muapi-cli

# 方式三：免安装直接运行（适合临时试用）
npx muapi-cli --help

提示：安装完成后，可通过 muapi --install-completion bash (或 zsh/fish) 启用命令自动补全。

基本使用

1. 认证与配置

首次使用前需注册账号或配置现有的 API Key。

新用户注册流程：

# 注册账号（将发送 OTP 验证码到邮箱）
muapi auth register --email you@example.com --password "your_password"

# 验证邮箱（填入收到的 6 位验证码）
muapi auth verify --email you@example.com --otp 123456

# 登录并自动保存 API Key
muapi auth login --email you@example.com --password "your_password"

已有 API Key 的用户：

# 直接配置 API Key
muapi auth configure --api-key "YOUR_EXISTING_KEY"

2. 生成内容

配置完成后，即可直接使用提示词生成多媒体内容。

生成图像：

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"

3. 查看状态与余额

# 查看账户信用额度
muapi account balance

# 等待正在运行的任务完成（若未加 --no-wait 默认会等待）
muapi predict wait <request_id>

4. 高级用法提示

• 机器友好模式：添加 --output-json 或 -j 可输出原始 JSON，配合 --jq 进行数据过滤，便于脚本集成。
• 自动下载：使用 --download ./outputs 可将生成结果自动保存到本地目录。
• AI 智能体集成：运行 muapi mcp serve 可启动 MCP 服务器，供 Claude Desktop 或 Cursor 等 AI 编辑器调用。