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

API Key 配置

为 Claude Code、Codex、OpenCode、Hermes 生成一份配置,也可以一键导入 CC Switch。

选择你的 AI 工具

使用方式
系统

Codex 的本地配置

DeepSeek V4 Flash Vision Exp · 命令行 · macOS

导入到 CC Switch

选择要导入的工具、模型和 API Key。

API Key

加载中…

将所选 Key 交给本机 CC Switch;在客户端确认导入后再切换。

Responses API · https://api.hiapi.ai/v1

没打开?安装或更新 CC Switch 后重试,或继续手动配置。

开始前Codex CLI 0.134+ · 命令行模式:请先在终端确认 Codex CLI 版本。codex --version安装说明 ↗

1保存配置文件

在用户主目录的 .codex 文件夹内,新建 hiapi.config.toml,将下面的配置粘贴进去并保存。文件夹不存在时先创建。

保存位置~/.codex/hiapi.config.toml

~ 表示你的用户主目录;.codex 是其中的隐藏文件夹。

以下内容写入配置文件
model_provider = "hiapi"
model = "deepseek-v4-flash-vision-exp"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

已经有这个文件?

原来的 config.toml 保持不变。如果已有 hiapi.config.toml,更新顶层 model、model_provider 和 [model_providers.hiapi] 中对应字段,保留其他设置,不要重复添加同名字段或表。

2在终端设置 API Key

打开 终端(bash / zsh),将 YOUR_HIAPI_API_KEY 替换为你的 Key,再运行下面的命令。这行命令不要写进配置文件。 管理 API Key ↗

复制命令
export HIAPI_API_KEY="YOUR_HIAPI_API_KEY"

3在同一个终端启动 Agent

在刚才设置 Key 的终端中,进入你要操作的项目目录,再运行下面的命令。它会加载 hiapi.config.toml;原来的默认配置保留。 关闭终端后,需在新终端重新设置 Key。启动后发送一条消息,再到请求记录确认调用结果。

启动命令
codex --profile hiapi

4用第一条消息确认接入

启动后,在同一个 Agent 对话中发送:

请只回复 HIAPI_OK,不要读取或修改文件。

收到文字后,还要到请求记录核对模型与状态;复制提示不会自动证明已连通。 查看请求记录 ↗

没有回复?

先检查 API Key、请求记录、模型和 CLI 版本。思考模型可能需要更久,不要盲目设置极低输出上限,也不要强制关闭思考或修改已有配置。

协议: Responses API查看官方配置说明 ↗