Agent Skills

安装 MuAPI Agent Skills，即可直接通过 Claude Code、Cursor、Gemini CLI 以及其他兼容 MCP 的工具生成 AI 図像、視频和音频。

概览

MuAPI Agent Skills 是预构建、由 Schema 驱動的 Shell 脚本，让你的 AI 编程 Agent 能够直接在终端中生成、编辑和增强丰富媒体。

  • 预构建技能： 覆盖図像、視频、音频、特效等任务
  • 動态 Schema 驱動： 脚本会根据 schema_data.json 自動解析最新モデル、エンドポイント和有效参数
  • 直接查看媒体： 使用 --view 标志即可下载并立即打开生成的媒体
  • 本地文件支持： 脚本会自動将本地図像、視频、人脸和音频上传到 MuAPI CDN
  • 100 多种 AI モデル： Midjourney v7、Flux Pro、Kling 3.0、Veo3、Suno V5 等

クイックスタート

1. 安装 Skills

# 通过 skills registry 安装全部 MuAPI skills
npx skills add SamurAIGPT/Generative-Media-Skills --all

# 或安装指定 skill
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-media-generation

# 列出可用 skills
npx skills add SamurAIGPT/Generative-Media-Skills --list

2. 配置 API Key

# 在 https://muapi.ai/dashboard 获取 Key
bash core/platform/setup.sh --add-key "YOUR_MUAPI_KEY"

3. 生成第一枚図像

bash core/media/generate-image.sh \
  --prompt "a cyberpunk cityscape at dusk, neon reflections on rain-slicked streets" \
  --model flux-dev \
  --view

4. 生成第一个視频

bash core/media/generate-video.sh \
  --prompt "A timelapse of a city skyline transitioning from day to night" \
  --model minimax-pro \
  --duration 5 \
  --view

可用 Skills

MuAPI Skills 分として三類：生成、编辑与增强以及平台工具。

生成 Skills

Skill脚本説明
文本转図像core/media/generate-image.sh根据文本提示词生成図像。支持 Flux Dev、Midjourney v7 和 50 多种モデル。
文本转視频core/media/generate-video.sh根据文本提示词生成視频。支持 Minimax Pro、Kling、Veo3 等。
図像转視频core/media/image-to-video.sh将静态図像制作成視频。支持 Kling Pro、Veo3、Runway 和 15 多种モデル。
音乐与音频core/media/create-music.sh創建音乐（Suno V5）、音效（MMAudio）、混音和扩展曲目。
文件上传core/media/upload.sh上传本地図像、視频和音频，并获取供其他 Skill 使用的 CDN URL。

编辑与增强 Skills

Skill脚本説明
図像编辑core/edit/edit-image.sh使用提示词编辑図像，支持 Flux Kontext、GPT-4o、Midjourney 等。
図像增强core/edit/enhance-image.sh一键执行高画質化（超解像）辨率、背景移除、人脸替换、上色、Ghibli 风格、产品図等操作。
リップシンクcore/edit/lipsync.sh让視频口型与音轨同步。支持 Sync Labs、LatentSync、Creatify、Veed。
視频特效core/edit/video-effects.shとして視频/図像应用 Wan AI 特效、人脸替换、舞蹈動画、换装、Luma 修改/重构等效果。

Workflow Skills（CLI 驱動）

AI Workflow 生态現在由 muapi-cli 集中驱動，提供专门用于 LLM 自主导航的工具。

Skill命令/脚本説明
創建与编辑muapi workflow create<br>muapi workflow edit使用自然语言提示词創建或编辑多节点 AI 管线。
Agent 発現muapi workflow discover获取已保存 Workflow 的完整目录（包含 AI 生成的説明），供 LLM 按语义匹配用户意図。
执行muapi workflow execute通过 API 使用自定义输入直接执行 Workflow。
交互式运行muapi workflow run-interactive获取输入 Schema，并主動询問用户必須值的交互式 CLI 流程。

平台 Skills

Skill脚本説明
設置core/platform/setup.sh配置 API Key、显示配置并测试 Key 有效性。
检查结果core/platform/check-result.sh根据 request ID 轮询异步生成结果。支持单次查询和轮询模式。

Skills 的工作方式

每个 Skill 都是由 schema_data.json 驱動的独立 Shell 脚本，用于動态解析モデル和エンドポイント：

muapi-skills/
├── core/
│   ├── media/           # Generation primitives
│   │   ├── generate-image.sh
│   │   ├── generate-video.sh
│   │   ├── image-to-video.sh
│   │   ├── create-music.sh
│   │   └── upload.sh
│   ├── edit/            # Editing & enhancement
│   │   ├── edit-image.sh
│   │   ├── enhance-image.sh
│   │   ├── lipsync.sh
│   │   └── video-effects.sh
│   └── platform/        # Setup & polling
│       ├── setup.sh
│       └── check-result.sh
└── schema_data.json     # Dynamic model registry

核心設计原则：

  • 脚本输出干净的 JSON，方便 Agent 无缝集成
  • 所有脚本都支持 --async，适用于即発即忘的异步流程
  • --view 标志会自動下载并打开生成的媒体
  • schema_data.json 在运行時校验モデル、解析エンドポイント并检查参数

本地文件上传

大多数编辑和媒体生成脚本現在支持“文件优先”流程。不必提供公开 URL，你可以直接提供本地文件路径（例如 --file ./photo.jpg 或 --face-file ./face.png）。

脚本会：

  1. 自動将本地文件上传到 MuAPI CDN。
  2. 解析返回的 URL。
  3. 使用该 URL 提交生成/编辑任务。
  4. 清理临時状态（如适用）。

这样，你的 AI Agent 可以在本地处理媒体存储，同時使用云端 AI モデル。

兼容性

针对新一代 AI 开発环境進行了优化：

  • Claude Code： 通过工具直接在终端中执行
  • Gemini CLI / Cursor / Windsurf： 作として本地脚本无缝集成
  • MCP： 每个 Skill 都支持 Model Context Protocol，可通用于不同 Agent

常用标志

所有核心脚本都共享一组一致的标志：

标志説明
--prompt、-p生成用的文本説明
--model、-mモデル名称（由脚本提供默認值）
--async立即返回 request_id，不等待完成
--view下载并打开结果（macOS）
--file、--image-file 等用于自動上传的本地文件路径（取决于脚本）
--json仅输出原始 JSON（方便管道处理）
--timeout N超時前的最大等待秒数
--help、-h显示使用方式和可用選项

相関連：Workflow 配方発現

如果 Agent 更偏好使用自然语言配方，而不是 Shell 脚本原语，muapi assistant 提供 40 多个端到端 Workflow SKILL.md 文件（絵コンテ・ストーリーボード、action figure 生成器、广告創意等），并通过一个公开、无需身份验证的 API 提供访問：

  • GET https://api.muapi.ai/api/v1/agent-skills — 列出所有配方
  • GET https://api.muapi.ai/api/v1/agent-skills/{name} — 获取完整 Markdown 内容

详见 Agents API → 公开 Workflow 配方発現。

次のステップ

  1. 在 muapi.ai/ja/dashboard APIキーの取得
  2. 配置 Agent： bash core/platform/setup.sh --add-key "YOUR_KEY"
  3. 开始生成： 尝试上面的快速开始示例
  4. 探索モデル： 浏览 Playground，発現 100 多种可用モデル
Agent Skills — Muapi Docs