MuAPI CLI

MuAPI 官方命令行界面允许你直接在终端中生成图像、视频和音频。

它采用 Agent 优先的设计 — 每个命令既适合人类使用（彩色输出、表格），也适合 AI Agent 使用（--output-json、语义化退出码、MCP Server 模式）。

安装

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

# pip
pip install muapi-cli

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

快速开始

# 身份验证
muapi auth login --email you@example.com --password "..."

# 或配置已有 API key
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 auth login：登录并保存 API key。
  • muapi auth configure：手动保存 API key。
  • muapi account balance：显示当前积分余额。

媒体生成

使用我们集成的 100 多种 AI 模型生成内容。

  • muapi image generate <prompt>：文本转图像生成。
  • muapi video generate <prompt>：文本转视频生成。
  • muapi audio create <prompt>：使用 Suno 创建音乐。

媒体增强与编辑

处理已有图像和视频。

  • muapi enhance upscale <url>：AI 图像超分辨率。
  • muapi enhance face-swap --source <url> --target <url>：替换图像/视频中的人脸。
  • muapi edit lipsync --video <url> --audio <url>：让口型与音频同步。

Workflow 编排

构建并运行多节点智能管线。

  • muapi workflow discover：获取可供 LLM 匹配的 Workflow 目录。
  • muapi workflow create <prompt>：使用自然语言创建新的 Workflow。
  • muapi workflow run-interactive <id>：通过引导式 CLI 流程运行 Workflow。

Agent 集成

MuAPI CLI 专为 AI 编程助手打造。

Agent 全局选项

  • --output-json / -j：输出原始 JSON 响应（关闭表格和彩色输出）。
  • --jq <expr>：直接筛选 JSON 输出（例如 '.outputs[0]'）。
  • --no-wait：异步提交任务并返回 request_id。

MCP Server

MuAPI 通过 Model Context Protocol 提供工具。托管 Server 有 19 个工具；本地 stdio Server（muapi mcp serve）有 24 个工具 — 它额外提供 muapi_upload_file 和 5 个社交发布工具，但不包含 search_models。连接方式有两种：

方式 1 — 托管 Server（无需安装）： 使用基于 Streamable HTTP 传输的托管 Server：https://api.muapi.ai/mcp。

# Claude Code — 一条命令完成设置
claude mcp add --transport http muapi \
  https://api.muapi.ai/mcp \
  --header "Authorization: Bearer YOUR_MUAPI_KEY"

对于 Cursor、Windsurf 和其他客户端，请参阅完整的 MCP Server 文档。

方式 2 — stdio（Claude Desktop）： 将 CLI 作为本地 stdio MCP Server 运行。

muapi mcp serve

Claude Desktop 配置（claude_desktop_config.json）：

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

Shell 补全

启用自动补全，加快 Workflow 操作：

muapi --install-completion bash
muapi --install-completion zsh
muapi --install-completion fish
MuAPI CLI — Muapi Docs