apiway / quick-start
ready
$ set BASE_URL=https://cn.apiway.cc/v1
$ set API_KEY=sk-apiway-your-key
$ run model=gpt-5.6
$ set API_KEY=sk-apiway-your-key
$ run model=gpt-5.6
12:08:21authenticationOK
12:08:22route /v1/responses200
12:08:23usage recordedDONE
按工具查看,
不读无关步骤。
不同客户端的字段名称略有差异。选择正在使用的工具,复制对应地址和变量。
Codex CLI
通过环境变量指定 OpenAI 兼容接口。配置完成后重新打开终端,再启动 Codex。
- 国内网络优先使用 CN 入口
- API Key 不要提交到代码仓库
- 模型名称以控制台可用列表为准
Base URL
https://cn.apiway.cc/v1
API Key
sk-apiway-your-key
# PowerShell
$env:OPENAI_BASE_URL="https://cn.apiway.cc/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"
codex
Claude Code
Claude Code 会自行拼接 Anthropic 请求路径,因此 Base URL 使用域名根地址,不添加 /v1。
- Base URL 不要以 /v1 结尾
- 使用 ANTHROPIC_AUTH_TOKEN 保存密钥
- 可用 Claude 模型名称以控制台为准
Base URL
https://cn.apiway.cc
Auth Token
sk-apiway-your-key
# PowerShell
$env:ANTHROPIC_BASE_URL="https://cn.apiway.cc"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude
Cherry Studio
新建 OpenAI 类型的服务商,填写 API Key 与接口地址,再添加控制台中可用的模型名称。
- 服务商类型选择 OpenAI
- API 地址填写到 /v1
- 建议先用 gpt-5.4 发送简短测试
服务商类型
OpenAI
API 地址
https://cn.apiway.cc/v1
模型示例
gpt-5.4
API Key: YOUR_API_KEY API Host: https://cn.apiway.cc/v1 Model: gpt-5.4
OpenClaw
在模型提供商中选择 OpenAI Compatible,填入接口地址、API Key 和模型名称。
- 提供商使用 OpenAI Compatible
- Base URL 填写到 /v1
- 字段名随 OpenClaw 版本可能略有不同
Provider
OpenAI Compatible
Base URL
https://cn.apiway.cc/v1
Model
gpt-5.4
provider: openai-compatible base_url: https://cn.apiway.cc/v1 api_key: YOUR_API_KEY model: gpt-5.4
先发一条最小请求,确认连通。
配置完成后先测试短消息。请求成功后,模型、Token、费用和耗时会进入控制台使用记录。
curl / chat-completions
curl https://cn.apiway.cc/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "你好"}]
}'
预期状态
HTTP 200
出错时,
先看状态码。
大多数接入问题来自密钥、余额、模型名称或地址格式。按状态码检查会更快。
401 密钥无效或请求头格式不对 +
确认密钥没有多余空格,Authorization 请求头格式为
Bearer YOUR_API_KEY。密钥泄露或被删除后,请在控制台重新创建。402 余额不足或上游额度受限 +
先检查 APIWay 控制台余额和使用记录。若账号余额正常但仍报错,可联系支持并提供请求时间与模型名称。
404 接口路径或模型名称错误 +
OpenAI 兼容工具的 Base URL 通常需要以
/v1 结尾。模型名称必须与控制台可用模型完全一致。429 请求频率过高或通道繁忙 +
降低并发并等待几秒后重试。自动化脚本建议增加指数退避,不要在失败后立即无限循环请求。