AiHubMix Documentation Hub

简介

Aihubmix 使用统一接口的方式整合了市面上主流的图片生成 API，以 MCP 的方式封装设计，让开发者们可以更便利地整合到与 LLM 的交互中，用户使用自然语音输入，即可触发图片生成。目前整合的模型如下：

openai/gpt-image-1
bfl/FLUX.1-Kontext-pro
google/imagen-4.0-ultra-generate-preview-06-06
google/imagen-4.0-generate-preview-06-06
ideogram/V3

gpt-image-1 模型的返回结果为 base64 编码，在 Claude Desktop 中可能会因为太长导致报错。目前建议优先使用 V3 / Flux / Imagen。

1️⃣ 安装

根据您使用的工具选择对应的安装方式：

工具	安装方式	适合人群
Claude Code（终端命令行）	Claude Code 安装方式	开发者，一条命令完成安装，可与代码工作流无缝结合
Claude Desktop（桌面 App）	Claude Desktop 安装方式	普通用户，配置后直接在 App 对话即可生成图片，无需编程基础
Cursor / Windsurf 等 AI 编辑器	IDE 配置文件方式	开发者，在项目目录添加配置文件，图片生成能力直接集成到编码环境
Warp AI（终端工具）	Warp AI 安装方式	开发者，在终端 AI 对话中直接触发图片生成，无需切换工具

下面是一些常用 AI 工具的 MCP 安装方式示例，运行指令之前需要将 sk-*** 替换为你的 Aihubmix 密钥。安装之后都需要重启工具才能生效。

安装到 Claude Code

第一步：终端运行安装指令

claude mcp add --transport http aihubmix-api https://aihubmix.com/mcp/ \
  --header "Authorization: Bearer sk-***" 

第二步：启动 Claude Code（安装指南见。。。）

claude

在终端输入 claude 回车，进入交互界面。 第三步：输入 /mcp 确认在 Claude Code 的对话输入框里输入：

/mcp

回车后会显示当前已连接的 MCP 服务列表，如果看到 aihubmix-api 且状态为 ✔ connected，说明安装成功。

如果状态是 failed 或没有出现，检查两点：

密钥是否替换了（不能是 sk-***）

重新运行安装指令后再试

安装到 Claude Desktop

Claude Desktop 是 Anthropic 官方出品的桌面客户端应用，包含两个入口：对话界面（Chat）和 Code 标签页，两者的 MCP 配置相互独立。本文档的 Claude Desktop 安装方式适用于对话界面。官方下载页：https://code.claude.com/docs/en/desktop 支持 macOS 和 Windows，下载安装包后直接安装即可。 第一步：打开配置文件 点击 Claude Desktop 右上角头像 → Settings → Developer → Edit Config 打开 claude_desktop_config.json 文件。 第二步：加入以下配置 将 sk-*** 替换为你的 Aihubmix 密钥后，添加到 mcpServers 对象中：

{
  "mcpServers": {
    "aihubmix-mcp-stdio": {
      "command": "npx",
      "args": ["-y", "@aihubmix/mcp"],
      "env": {
        "AIHUBMIX_API_KEY": "sk-***"
      }
    }
  }
}

如果文件已有其他 MCP 配置，只需把 aihubmix-mcp-stdio 这段加进 mcpServers 里，注意保持 JSON 格式正确（上一项末尾加逗号）。

第三步：重启 Claude Desktop 完全退出后重新打开，在对话界面底部工具栏应出现 🔨 图标，点击可确认 aihubmix-mcp-stdio 已连接。头像 → Settings → Developer → Edit Config → 加入以下配置

"aihubmix-mcp-stdio": {
    "command": "npx",
    "args": ["-y", "@aihubmix/mcp"],
    "env": {
      "AIHUBMIX_API_KEY": "sk-***"
    }
}

安装到 Warp AI

第一步：打开 MCP 配置入口 点击右上角头像 → Settings → AI → Manage MCP Servers → Add 第二步：加入以下配置 将 sk-*** 替换为你的 Aihubmix 密钥：

{
  "aihubmix-mcp-stdio": {
    "command": "npx",
    "args": ["-y", "@aihubmix/mcp"],
    "env": {
      "AIHUBMIX_API_KEY": "sk-***"
    },
    "working_directory": null
  }
}

第三步：保存并重启 Warp 保存配置后重启 Warp，在 AI 对话中即可使用图片生成功能。

前提条件： 需已安装 Node.js（node -v 确认版本 ≥ 18）。Warp 下载：warp.dev

2️⃣ 使用

使用自然语言输入，指定 mcp 和目标，比如：

prompt

使用 aihubmix mcp 绘制一只可爱小猫在花园里玩耍，Pixar 3d 卡通风格，3:2,, 自动为我优化 prompt 并执行

Claude Desktop 使用示例：使用 Aihubmix MCP

可以指定目标模型，比如 flux-kontext-max、ideogram/V3 等，不需要精确对应，LLM 会自动匹配关键字眼
指定更多参数，比如

prompt

影视光、低视角、模型 V3，生成 2 张

Documentation Index

​简介

​1️⃣ 安装

​安装到 Claude Code

​安装到 Claude Desktop

​安装到 Warp AI

​2️⃣ 使用

简介

1️⃣ 安装

安装到 Claude Code

安装到 Claude Desktop

安装到 Warp AI

2️⃣ 使用