MCP

HiAPI 提供托管的远程 MCP（Model Context Protocol）服务。任何 MCP 兼容客户端——Claude Code、Cursor 等——连接一次即可获得一组图片和视频生成工具，底层全部走统一异步接口。无需在本地安装或运行任何东西。

https://mcp.hiapi.ai/mcp

服务端不保存任何凭证：你的 API Key 只随每次请求的 Authorization 头转发给 api.hiapi.ai。

连接

鉴权使用你的 HiAPI API Key 作为 Bearer token。在控制台 → API Keys 创建。

Claude Code
JSON 配置

claude mcp add --transport http hiapi https://mcp.hiapi.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

适用于通过 JSON 文件配置的客户端（Cursor、Claude Desktop 等）：

{
  "mcpServers": {
    "hiapi": {
      "type": "http",
      "url": "https://mcp.hiapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

连接后让客户端列出工具，或直接说「生成一张……的图」——客户端会自行发现并调用对应工具。

工具

工具	能力	默认模型
`generate_image`	文生图；支持参考图的模型可带参考图生成	`qwen-image-2.0`
`edit_image`	编辑或改写现有图片（图生图）	`Nano-Banana-2`
`generate_video`	文生视频和图生视频	`seedance-2-0`
`list_models`	列出全部支持的图片/视频模型及能力概要	—
`get_model_capabilities`	模型参数明细：比例、分辨率、输出格式、参考图上限、时长	—
`get_pricing`	从 `/api/pricing` 获取实时价格	—

所有生成工具都通过 POST /v1/tasks 创建任务，并轮询 GET /v1/tasks/:id 最多 3 分钟。耗时更长的生成请传 wait_for_completion: false，立刻拿到 taskId，稍后通过任务详情接口查询。

支持的模型与公开目录一致——具体参数见模型页。模型专属字段（如 Seedance 参考视频、Wan 的 ratio、FLUX 的 safety_tolerance）都直接作为工具参数暴露，并在 get_model_capabilities 中有说明。

排障

现象	处理
工具返回 `401` / `403`	检查客户端配置里的 `Authorization: Bearer …` 头
余额或配额错误	到控制台 → 充值充值
工具调用超时	任务可能仍在运行——改用 `wait_for_completion: false` 再轮询 `GET /v1/tasks/:id`
客户端连不上	确认 URL 是 `https://mcp.hiapi.ai/mcp`，传输方式为 HTTP（streamable）

想在 Agent 运行环境里按模型使用？安装 Skills。在自己的产品或后端集成？直接调用统一异步接口。