公告: 可灵 Kling 4.0 上新,文生视频与图生视频限时 8 折,立即体验
HiAPI
教程目录

MCP 一键接入

HiAPI Remote MCP 让 Claude、ChatGPT、Codex 等直接调用 HiAPI 生成图片、视频和音频。

选择你的 AI 工具

把这段提示词发给 Codex

粘贴给这个客户端里的 AI,它会帮你配置并发起授权。

  1. 1 点「复制提示词」
  2. 2 粘贴到 Codex 的对话框并发送
  3. 3 浏览器会打开 HiAPI 授权页:登录、选好额度,点同意
请在我实际使用的环境里帮我接入 HiAPI MCP。需要我本人点的步骤(在客户端里点按钮、在浏览器里同意授权)必须写清楚,我只做这些;不要让我粘贴命令、授权码或回调地址。

目标客户端:Codex
服务名称:hiapi
MCP 地址:https://mcp.hiapi.ai/mcp(Streamable HTTP + OAuth)

请按顺序做:
1. 先确认你就是 Codex,并说出你依据的环境证据(运行平台、你自己的配置目录或插件目录是否存在),不要只凭自我声明。下面的配置都在你实际运行的环境(macOS / Linux / Windows / WSL,本地或远程服务器)里做。
2. 先运行 `codex mcp get hiapi`。没有这个连接时再运行:`codex mcp add hiapi --url https://mcp.hiapi.ai/mcp --oauth-client-id hiapi-codex`;已存在且地址一致就保留。
3. 添加时 Codex 会直接打开浏览器授权,等我完成即可。如果没有打开,或 `codex mcp list` 里 hiapi 仍未登录,再运行 `codex mcp login hiapi`,等我在浏览器里完成授权。接下来会打开 HiAPI 授权页,由我登录、确认并设好额度;打不开浏览器时按上一步把链接给我。本次最多发起一次授权。
4. 授权完成后,调用 hiapi 的 get_balance 确认连通;调用失败可以再试一次,仍然失败就停下,把错误原文告诉我。不要调用任何会扣费的工具(出图、视频、音频、文本生成)。如果当前会话还看不到 hiapi 的工具,提醒我重启会话,不要重复授权。
5. 修改配置文件时保留其他已有条目;不要在对话、日志或命令回显里暴露 access token、授权码、code_verifier 等凭据。
6. 完成后分两部分简短汇报。你自己核实过的:改了哪个配置(文件或界面里的设置;已经有了就写没改),查余额的结果和余额。需要我确认的:我在浏览器里是否已同意授权、是否需要我重启客户端。

如果实际情况和这些步骤只有小出入(例如配置文件不存在、已有条目的格式略有不同),按实际情况处理,并在汇报里标出和步骤不一样的地方。如果找不到提到的界面或设置项、命令不存在、客户端不是上面说的那个,或者要做这些步骤以外的改动,先停下,告诉我你看到了什么,不要自己猜着换别的做法。
汇报只写你实际做过、亲眼看到的结果;我那边的操作(比如浏览器里是否已同意授权)你看不到,就写「待你确认」,不要写成已完成。

手动配置

想自己改配置?复制下面的命令或文件内容。

服务地址
https://mcp.hiapi.ai/mcp
添加
codex mcp add hiapi --url https://mcp.hiapi.ai/mcp --oauth-client-id hiapi-codex
授权
codex mcp login hiapi

常见问题

客户端连不上
确认地址是 https://mcp.hiapi.ai/mcp,传输方式选 HTTP(Streamable)。
提示余额或配额不足
去控制台充值后再试 ↗
生成结果还没出来
任务还在运行。让 AI 用同一个 task_id 继续查询,不要重新提交。

管理已连接的应用