跳转至

5 分钟快速开始

本页按 RouteFast 的 sub2api 分组方式接入。只想使用终端编码工具？可直接阅读 Claude Code 或 Codex CLI。

1. 准备账户和额度

打开 RouteFast 控制台，按页面提示注册、验证邮箱并登录。按你实际使用的分组确认可用余额或有效订阅；支付渠道、到账金额与服务条款以控制台展示为准。

2. 创建对应分组密钥

进入 API 密钥，创建并命名密钥：

用途 分组 接入地址
GPT API / Codex CLI OpenAI-ChatGPT https://api.routefast.ai/v1
Claude API / Claude Code Anthropic-Claude https://api.routefast.ai

从列表复制完整密钥，妥善保存。不要复制掩码文本，也不要把本站密钥填入 OpenAI 或 Anthropic 官方站点。更多选项见 密钥与控制台。

两种用途使用对应分组 Key

一个账户可以管理多把密钥，但不要假定一把密钥可以跨分组调用全部模型。下面的 GPT 和 Claude 示例要分别使用各自分组的密钥。

3. 检查模型列表

将占位符替换为刚创建的密钥；以下变量只对当前终端及其子进程生效。不要共享含密钥的命令历史或截图。

export ROUTEFAST_API_KEY="sk-routefast-..."
curl -sS --connect-timeout 10 --max-time 30 \
  -w '\nHTTP %{http_code}\n' \
  https://api.routefast.ai/v1/models \
  -H "Authorization: Bearer $ROUTEFAST_API_KEY"

$env:ROUTEFAST_API_KEY = "sk-routefast-..."
$headers = @{ Authorization = "Bearer $env:ROUTEFAST_API_KEY" }
$models = Invoke-RestMethod -Method Get `
  -Uri "https://api.routefast.ai/v1/models" `
  -Headers $headers -TimeoutSec 30
$models | ConvertTo-Json -Depth 10

成功时应看到模型集合；确认准备调用的模型 ID 在该密钥的结果中。这一步检查模型查询的网络与鉴权，不代表生成请求、所有模型或高级参数均已验证。

如果报错，保留状态码与错误体，查看 故障排查。余额不足、Key 总额度和速率限制不是同一件事，详见 限流与额度。

4. 发起首次生成

这一步会产生实际模型用量。先选一种用途测试，替换密钥后再测试另一种。

GPT / Responses

使用 OpenAI-ChatGPT 分组密钥，模型 ID 必须在你的可用列表中。

curl -sS --connect-timeout 10 --max-time 120 \
  -w '\nHTTP %{http_code}\n' \
  https://api.routefast.ai/v1/responses \
  -H "Authorization: Bearer $ROUTEFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","input":"只回复 OK"}'

$headers = @{ Authorization = "Bearer $env:ROUTEFAST_API_KEY" }
$body = @{ model = "gpt-5.6-terra"; input = "Reply only OK" } |
  ConvertTo-Json
$result = Invoke-RestMethod -Method Post `
  -Uri "https://api.routefast.ai/v1/responses" `
  -Headers $headers -ContentType "application/json" `
  -Body $body -TimeoutSec 120
$result | ConvertTo-Json -Depth 20

预期：收到正常 JSON，status 为 completed，output 的文本内容中有回复。以下为简化响应示意，实际回复文字可能不同：

{"status":"completed","output":[{"type":"message","role":"assistant","content":[{"type":"output_text","text":"OK"}]}]}

Claude / Messages

先将 ROUTEFAST_API_KEY 替换成 Anthropic-Claude 分组密钥。

curl -sS --connect-timeout 10 --max-time 120 \
  -w '\nHTTP %{http_code}\n' \
  https://api.routefast.ai/v1/messages \
  -H "Authorization: Bearer $ROUTEFAST_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":256,"messages":[{"role":"user","content":"只回复 OK"}]}'

$headers = @{
  Authorization = "Bearer $env:ROUTEFAST_API_KEY"
  "anthropic-version" = "2023-06-01"
}
$body = @{
  model = "claude-sonnet-5"
  max_tokens = 256
  messages = @(@{ role = "user"; content = "Reply only OK" })
} | ConvertTo-Json -Depth 5
$result = Invoke-RestMethod -Method Post `
  -Uri "https://api.routefast.ai/v1/messages" `
  -Headers $headers -ContentType "application/json" `
  -Body $body -TimeoutSec 120
$result | ConvertTo-Json -Depth 20

预期：type 为 message，content 中有文本回复，stop_reason 表示正常结束。以下仅为省略字段的结构示意：

{"type":"message","role":"assistant","content":[{"type":"text","text":"OK"}],"stop_reason":"end_turn"}

5. 在控制台核对用量

打开 使用记录，按本次时间范围、API 密钥和模型筛选。核对模型、Token 和费用；刚结束的请求可稍后刷新。页面的输入量与原始 API usage 不一定是同一个口径，见 读懂账单。

完成标准是“收到正常生成结果，并能核对对应使用记录”，而不是只看到 HTTP 200。使用流式接口时，还要检查正常结束事件。

下一步