搜索

搜索 HiAPI 模型、工具和资源。

将 HiAPI 接入你的 Agent

选择工具和模型,复制配置,在本地开始使用。

选择你的 Agent
使用方式
开始前Codex CLI 0.134+ · 命令行模式:请先在终端确认 Codex CLI 版本。
codex --version安装说明
Codex的本地配置配置预览

01保存配置文件

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

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

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

已经有这个文件?

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

以下内容写入配置文件
model_provider = "hiapi"
model = "gpt-6-astra"

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

02在终端设置 API Key

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

管理 API Key
export HIAPI_API_KEY="YOUR_HIAPI_API_KEY"

03在同一个终端启动 Agent

在刚才设置 Key 的终端中,进入你要操作的项目目录,再运行下面的命令。它会加载 hiapi.config.toml;原来的默认配置保留。

关闭终端后,需在新终端重新设置 Key。启动后发送一条消息,再到请求记录确认调用结果。

codex --profile hiapi

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

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

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

协议: Responses API查看官方配置说明
没有回复?

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

准备好你的 API Key

在控制台创建 Key,并按配置说明在本地填入。

管理 API Key

用第一条消息确认接入

启动 Agent 发送消息,再到请求记录核对结果。测试调用按模型价格计费。

查看请求记录