接入文档

从注册到第一次调用。

AsterRoute 支持兼容 OpenAI 的 Chat Completions、Responses API，以及与官方配置完全隔离的 Codex 一键接入。

01 · 开始使用

四步完成接入

  1. 1
    申请账号

    使用自己的邮箱注册，密码至少 12 个字符。

  2. 2
    等待审核

    封闭内测账号需要站主人工审核后才能登录。

  3. 3
    创建 API Key

    完整 Key 只显示一次，请立即复制并安全保存。

  4. 4
    充值预付余额

    与站主确认付款后提交转账核对信息，审核通过即到账。

02 · CODEX

无需 CCSwitch，一条命令接入

打开 PowerShell 运行下面的命令。只有出现隐藏输入提示时，才粘贴你的 AsterRoute API Key。

irm https://asterroute.com/install-asterroute.ps1 | iex
不会覆盖官方 Codex

asterroute 使用 AsterRoute；/model 切换模型；codex 继续使用你的官方账号。

03 · API

兼容 OpenAI 的接口

Base URLhttps://asterroute.com/v1
Chat Completions/chat/completions
Responses/responses
Models/models
Service health/api/health

Chat Completions

curl https://asterroute.com/v1/chat/completions \
  -H "Authorization: Bearer $ASTERROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6","messages":[{"role":"user","content":"只回复 OK"}]}'

Responses API

curl https://asterroute.com/v1/responses \
  -H "Authorization: Bearer $ASTERROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","input":"只回复 OK"}'
04 · 模型

指定模型或使用自动路由

全部模型共用同一个 API Key 和预付余额。Chat Completions 支持完整目录；Codex 默认仍推荐 GPT‑5.6 Sol。

asterroute/autoAsterRoute Auto

按任务智能选择模型。

gpt-5.6-solGPT-5.6 Sol

旗舰编程与 Agent。

claude-opus-5Claude Opus 5

深度推理与代码审查。

kimi-k3Kimi K3

中文与长上下文。

deepseek-v4-proDeepSeek V4 Pro

低价推理与编程。

grok-4.5Grok 4.5

编程、理工与研究。

gemini-3.6-flashGemini 3.6 Flash

高速多模态任务。

kat-coder-proKAT Coder Pro

专用编程 Agent。

longcat-2.0LongCat 2.0

低价百万上下文。

查看完整模型与价格目录 ↗

模型可用性和上游价格可能变化，最终费用以客户后台的逐笔用量记录为准。

05 · 可靠性

客户端无需改动，服务端自动切换

配置多个上游后，遇到可重试的网络、鉴权、余额、限流或服务器故障时，AsterRoute 会尝试下一条兼容通道。客户的 Base URL、API Key 和模型名称都无需改变。

自动熔断

同一通道连续三次可重试故障后会暂时跳过；冷却两分钟后，下一次符合条件的请求会自动试探恢复。

站主管理后台会显示通道配置状态、熔断状态、近期流量、成功率、延迟和连续失败次数，不会显示任何上游密钥。

06 · 错误处理

常见状态码

401API Key 缺失、无效、已撤销或被停用。
402预付余额不足，请充值后重试。
403当前账号无权使用该模型或操作。
429已达到速率、每日消费或风控限制。
5xx上游或网关暂时故障，请延迟后重试。
07 · 切换与移除

随时切回官方 Codex

关闭 AsterRoute 终端后运行 codex 即可。更换 Key 时重新运行安装命令；彻底移除时运行：

irm https://asterroute.com/remove-asterroute.ps1 | iex