AI 编辑器接入手册

通用

接入准备

分享文档 ↗

1. 创建专用密钥

每分钟请求数先用 60；按需要设置月度预算、到期时间与模型权限。预算单位为美元，余额和预留额度不足时请求会被拒绝。API Key 不是网站登录密码，也不是上游供应商密钥。

IP 白名单应填写实际发出请求的公网 IP。由编辑器云端转发的请求可能不使用你的本机 IP。不要为排错公开密钥。

2. 地址与模型 ID

Base URL：https://nexusapi.wxbaohe.com/v1。大多数编辑器只填到 /v1，不要再拼接 /chat/completions，也不要重复 /v1。

模型 ID 必须完整复制，包含供应商前缀；显示名称不能替代 ID。下方示例不会包含你的真实密钥。

聊天开放不等于 Responses 已开放。Codex 必须选择具有 responses 能力的模型；其他编辑器需按实际协议选择。已开放模型仍需在该密钥的允许范围内。

3. 在终端准备密钥（只在本机执行）

macOS 的 zsh 可使用下方隐藏输入，不把真实密钥写入示例或命令历史。变量只在当前终端生效；图形界面程序未必继承终端环境。

zsh

read -rs "NEXUS_API_KEY?粘贴 Nexus API Key 后回车: "
export NEXUS_API_KEY
printf "\n"

Windows PowerShell

隐藏输入后转换为当前进程环境变量。密钥仍应视为敏感信息，不要打印环境变量或提交到代码仓库。

powershell

$nexusSecret = Read-Host "Nexus API Key" -AsSecureString
$env:NEXUS_API_KEY = [System.Net.NetworkCredential]::new("", $nexusSecret).Password
Remove-Variable nexusSecret

Linux / Bash

在 Bash 中使用下面的隐藏输入方式，随后在同一个终端运行命令。

bash

read -rsp "Nexus API Key: " NEXUS_API_KEY
export NEXUS_API_KEY
printf "\n"

4. 检查当前密钥可调用的模型

下面是 macOS/Linux cURL 示例；Windows 请使用下方完整 PowerShell 示例，不要直接复制 Bash 环境变量语法。/models 不生成内容，不产生模型推理费用，但会占用请求频率。返回的 capabilities 可区分 chat 与 responses。

bash

curl 'https://nexusapi.wxbaohe.com/v1/models' \
  -H "Authorization: Bearer $NEXUS_API_KEY"

5. 最小聊天测试（会按实际用量计费）

先替换 YOUR_CHAT_MODEL_ID；如果在已登录的 API 开发页面，选择模型即可自动填入。成功后再到编辑器验证；不要对失败请求无限重试。

bash

curl -N 'https://nexusapi.wxbaohe.com/v1/chat/completions' \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_CHAT_MODEL_ID","messages":[{"role":"user","content":"只回复 OK"}],"max_tokens":64,"stream":true}'

Windows：列出模型与最小聊天测试

先执行前面的 PowerShell 密钥输入。第一段只查询模型；第二段为可选的非流式生成测试，会按用量计费。请先替换模型占位符。

powershell

$nexusHeaders = @{ Authorization = "Bearer $env:NEXUS_API_KEY" }
Invoke-RestMethod -Uri 'https://nexusapi.wxbaohe.com/v1/models' -Headers $nexusHeaders

# 以下会产生实际模型费用
$nexusBody = @{ model = 'YOUR_CHAT_MODEL_ID'; messages = @(@{ role = 'user'; content = 'Reply OK only' }); max_tokens = 64; stream = $false } | ConvertTo-Json -Depth 6
Invoke-RestMethod -Method Post -Uri 'https://nexusapi.wxbaohe.com/v1/chat/completions' -Headers $nexusHeaders -ContentType 'application/json' -Body $nexusBody