MCP

HiAPI 提供托管的远程 MCP（Model Context Protocol）服务。MCP 兼容客户端连接该服务后，即可调用图片、视频、音频和文本生成工具。媒体工具使用统一异步接口，文本工具使用 OpenAI 兼容文本接口，无需本地部署。

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`
`generate_audio`	对话语音、音乐和其他在线音频模型	`elevenlabs/text-to-dialogue`
`generate_text`	使用任意在线文本模型生成文本，自动选择 Chat 或 Responses 接口	`deepseek-v4-flash`
`get_task_status`	按任务 ID 查询异步图片、视频或音频任务	—
`list_models`	列出实时图片、视频、音频和文本模型及能力概要	—
`get_model_capabilities`	模型参数明细：比例、分辨率、输出格式、参考图上限、时长	—
`get_pricing`	从 `/api/pricing` 获取实时价格	—

图片、视频和音频工具通过 POST /v1/tasks 创建任务，并轮询 GET /v1/tasks/:id 最多 3 分钟。耗时更长的生成请传 wait_for_completion: false，立刻拿到 taskId，稍后用 get_task_status 或任务详情接口查询。文本模型根据实时目录使用 /v1/chat/completions 或 /v1/responses；generate_text 返回完整 JSON，传 stream: true 会得到明确错误。

支持的模型与实时公开目录一致——具体参数见模型页。新的任务模型会通过 params 通用透传接入；模型专属字段（如 Seedance 参考视频、Wan 的 ratio、FLUX 的 safety_tolerance 和音频歌词）在 get_model_capabilities 中有说明。暂时没有对应 MCP 工具的 modality 会单独列出。

排障

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

需要在 Agent 运行环境中按模型调用？请安装 Skills。需要集成到产品或后端？请直接调用统一异步接口。