接入 MCP

这页是 HiAPI MCP 的配置教程。你只需要在 AI 工具的 MCP / Connectors 设置里新增一个 HiAPI 服务，填入远程地址和自己的 HiAPI API Key，就可以在对话里生成图片、编辑图片、创建视频或查询模型。

快速配置

获取 API Key

前往 HiAPI 控制台 → API Keys 创建或复制一个 API Key。
在 AI 工具里新增 MCP 服务

打开目标工具的 MCP、Connectors、Tools、Integrations 或 Servers 设置，新增一个服务，名称填写 hiapi。

你需要填写的内容如下：

配置项填写内容
Name / Server name hiapi
Type / Transport Remote、HTTP 或 Streamable HTTP
URL https://mcp.hiapi.ai/mcp
Header name Authorization
Header value Bearer 你的 HiAPI API Key
填写远程地址
```
https://mcp.hiapi.ai/mcp
```

填写鉴权请求头

Authorization: Bearer 你的 HiAPI API Key

保存并重启 AI 工具

多数 AI 工具只会在启动时加载 MCP 配置。保存后请完全退出目标工具，再重新打开。
验证连接

在聊天里输入：

请调用 HiAPI，列出可用图像模型，并用 gpt-image-2 生成一张产品海报。

JSON 配置模板

如果你的 AI 工具支持直接粘贴 JSON，可以使用下面的模板：

{
  "mcpServers": {
    "hiapi": {
      "url": "https://mcp.hiapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer 你的 HiAPI API Key"
      }
    }
  }
}

如果工具提供图形界面，填写项和上面的表格一致：

字段	填写内容
Name / Server name	`hiapi`
Type / Transport	`Remote`、`HTTP` 或 `Streamable HTTP`
URL	`https://mcp.hiapi.ai/mcp`
Header name	`Authorization`
Header value	`Bearer 你的 HiAPI API Key`

让 AI 自动配置

如果你希望 AI 帮你写配置，可以把本页或 llms.txt 提供给它，并告诉它：

请根据 HiAPI MCP 文档，把远程 MCP 地址和 Authorization 请求头写入当前工具的 MCP 配置，然后重启后用 list_models 和 generate_image 验证连接。

如何对 AI 提需求

连接成功后，你不需要手动填写工具字段。直接在聊天里说清楚你想做什么，AI 工具会自动选择 HiAPI MCP 工具，并按模型能力填写对应参数。

你想做什么	你可以这样说
生成图片	请用 `gpt-image-2` 生成一张 `16:9` 的产品海报，画面要干净，有中文标题
参考图片生成（仅部分模型支持）	请用 `Nano-Banana-2` 参考我上传的图片，生成一张日系杂志封面
编辑图片（需要支持改图的模型）	请用 `Nano-Banana-Pro` 编辑这张图片 `https://example.com/source.png`，把背景换成雪山
生成视频	请用 `seedance-1-5-pro` 生成一段 5 秒、`1920*1080` 的咖啡广告视频
使用本地上传图片生成视频（需要图生视频模型）	请用 `wan2.7-i2v` 让我上传的图片动起来，生成 5 秒横版视频
查看可用模型	请列出 HiAPI 当前可用的图片和视频模型
查看模型参数	请查看 `Nano-Banana-Pro` 支持哪些比例和分辨率
查看价格	请查询 `gpt-image-2` 的价格和倍率

如果你已经指定模型，AI 会优先使用你说的模型；如果你没有指定模型，可以让 AI 先查看模型列表和能力，再推荐合适的模型。

Nano-Banana、Nano-Banana-2、Nano-Banana-Pro 支持参考图，参考图是可选项：不上传时文生图，上传后可做参考图生成、风格转换或改图。
Nano Banana 系列参考图最多 14 张，支持 JPG、PNG、WebP；每张建议不超过 10MB。上传图片会在调用前压缩到最长边 2048px 以内。
edit_image 只适用于 Nano Banana 系列，并且需要至少 1 张原图；如果只是“带参考图生成”，也可以让 AI 调用 generate_image 并附带图片输入。
本地上传图片生成视频只适用于图生视频模型；目前 wan2.7-i2v 需要图片，seedance-2-0 可选传图片。首帧/尾帧支持 JPG、PNG、WebP，每张最大 10MB。
其他文生图模型如 gpt-image-2、gpt-image-2-beta、qwen-image-2.0、flux-1.1-pro 不支持上传参考图，不应调用 edit_image。
远程 MCP 不能直接读取你电脑上的本地文件路径。如果你在 AI 工具里上传图片，AI 工具需要把图片内容转成 data:image/...;base64,... 或 base64 后传给 HiAPI MCP，不要只传 /Users/.../image.png、C:\... 这样的本地路径。

高级：字段名参考（可跳过）

这些字段由 AI 工具自动填写，只有在排查 MCP 调用或让 AI 检查配置时才需要关注。日常使用时，直接按上面的示例描述需求即可。

prompt：生成、编辑或视频创作要求。
model：用户指定模型时填写，例如 gpt-image-2、Nano-Banana-Pro。
image_url、image_data_uri、image_base64 / image_mime_type、images：只在参考图、改图或图生视频场景使用。
aspect_ratio、image_size、size：控制图片比例、分辨率或视频画幅，具体取值以模型能力为准。
seconds：视频时长，仅视频模型使用。
wait_for_completion：视频任务是否等待完成后再返回结果。

如果某个模型不支持你要求的参数，AI 应先调用模型能力查询，再改用该模型支持的比例、尺寸、质量档位或工作流。

接入 Claude Desktop

获取 API Key

前往 HiAPI 控制台 → API Keys 创建或复制一个 API Key。
打开远程连接器 / MCP 设置

在 Claude Desktop 中找到 Connectors、MCP、Integrations 或 Tools 相关设置。不同版本入口可能不同。
添加 HiAPI 远程 MCP
- URL：https://mcp.hiapi.ai/mcp
- Header：Authorization
- Value：Bearer 你的 HiAPI API Key
重启 Claude Desktop

保存后完全退出 Claude Desktop，再重新打开。
试一试

在 Claude 里输入：

调用 HiAPI MCP，列出可用图像模型，并用 gpt-image-2 生成一张日落时分山间湖泊的电影感照片。

接入 Claude Code (CLI)

在 Claude Code 的远程 MCP 配置入口中填写 HiAPI 地址和鉴权请求头。

添加远程 URL

在 Claude Code MCP 配置入口中填写：

{
  "mcpServers": {
    "hiapi": {
      "url": "https://mcp.hiapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer 你的 HiAPI API Key"
      }
    }
  }
}

重启 Claude Code

配置完成后，完全退出当前 Claude Code 会话，然后重新启动。
验证

请调用 HiAPI MCP，先列出模型，再用 flux-1.1-pro 生成一张赛博朋克城市图片。

接入 Codex（CLI / Desktop）

在 Codex CLI 或 Codex Desktop 的远程 MCP 配置入口中填写 HiAPI 地址和鉴权请求头。

添加远程 MCP 配置

在 Codex MCP 配置文件或界面中写入：

{
  "mcpServers": {
    "hiapi": {
      "url": "https://mcp.hiapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer 你的 HiAPI API Key"
      }
    }
  }
}

重启 Codex
- 使用 Codex CLI：退出当前 codex 会话，然后重新启动。
- 使用 Codex Desktop：完全退出桌面应用，再重新打开。
试一试

调用 HiAPI MCP，列出可用图像模型，并用 Nano-Banana-Pro 生成一张开发者工作台插图。

接入 Cursor

打开 Cursor 设置。
找到 MCP、Tools 或 Integrations 相关入口。
新增一个 MCP Server。
配置远程 MCP 服务：

字段填写内容
Name hiapi
Type / Transport Remote、HTTP 或 Streamable HTTP
URL https://mcp.hiapi.ai/mcp
Header Authorization: Bearer 你的 HiAPI API Key
保存并确认连接状态正常。
打开 Cursor Chat (Cmd/Ctrl + L) 并输入：

使用 HiAPI MCP 列出图像模型，然后生成一张未来城市图片。

字段	填写内容
Name	`hiapi`
Type / Transport	`Remote`、`HTTP` 或 `Streamable HTTP`
URL	`https://mcp.hiapi.ai/mcp`
Header	`Authorization: Bearer 你的 HiAPI API Key`

接入 VS Code / GitHub Copilot

在 VS Code / GitHub Copilot 的远程 MCP 配置中填写 HiAPI 地址和鉴权请求头。

在 VS Code 中打开你的项目。
打开 MCP 相关设置或 .vscode/mcp.json。

写入类似配置：

{
  "servers": {
    "hiapi": {
      "type": "http",
      "url": "https://mcp.hiapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer 你的 HiAPI API Key"
      }
    }
  }
}

打开命令面板（Cmd/Ctrl + Shift + P），运行 MCP 相关的 List Servers / Start Server 命令。
在 Copilot Chat 中切换到 Agent Mode。
输入：

列出 HiAPI 可用图像模型，并帮我生成一张开发者工具风格的插图。

接入 Cherry Studio

在 Cherry Studio 中添加 HiAPI 远程 MCP 服务。

打开 Cherry Studio 设置。
找到 MCP Server 选项。
点击 Add server。
按下面填写：

字段填写内容
Name hiapi
Type Remote、HTTP 或 Streamable HTTP
URL https://mcp.hiapi.ai/mcp
Headers Authorization: Bearer 你的 HiAPI API Key
保存后，在聊天框里启用 hiapi MCP 服务。
输入：

用 HiAPI 生成一张极简科技风头像背景图。

字段	填写内容
Name	`hiapi`
Type	`Remote`、`HTTP` 或 `Streamable HTTP`
URL	`https://mcp.hiapi.ai/mcp`
Headers	`Authorization: Bearer 你的 HiAPI API Key`

接入其他 MCP 工具

如果你使用的 AI 工具支持远程 MCP，可以按通用方式接入 HiAPI。核心配置只有两个：远程 URL 和 Authorization 请求头。

确认工具支持远程 MCP

在目标工具的设置里找到 MCP、Tools、Extensions、Servers 或 Integrations 相关入口，确认它支持 Remote、HTTP 或 Streamable HTTP 类型。
添加一个新的 MCP Server

常见字段按下面填写：

字段填写内容
Name / Server name hiapi
Type / Transport Remote、HTTP 或 Streamable HTTP
URL https://mcp.hiapi.ai/mcp
Header Authorization: Bearer 你的 HiAPI API Key

如果工具要求 JSON 配置

使用下面这个通用模板：

{
  "mcpServers": {
    "hiapi": {
      "url": "https://mcp.hiapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer 你的 HiAPI API Key"
      }
    }
  }
}

保存并重启 AI 工具

多数 MCP 客户端只会在启动时加载 Server 配置。保存后请完全退出目标工具，再重新打开。
验证工具是否可用

在聊天里输入：

请列出 HiAPI MCP 当前可用模型，并告诉我哪个模型适合生成中文海报。

如果连接成功，AI 应该会调用 list_models 或 get_model_capabilities，并返回图像和视频模型列表。

通用排错

现象	处理方式
提示 401 或未授权	检查 Header 是否为 `Authorization: Bearer 你的 HiAPI API Key`
工具列表为空	保存配置后完全重启客户端
模型参数不确定	先让 AI 调用 `get_model_capabilities`
想确认价格	让 AI 调用 `get_pricing`，实时读取 HiAPI 价格信息
上传本地图片后失败	不要传本地文件路径；让 AI 把图片转成 `image_data_uri` 或 `image_base64`