Routeway 免费模型网关每天 200 次请求，280+ 模型适合原型验证

Routeway 是 OpenAI 兼容网关，凡是支持自定义 base_url 的 SDK 都能直连。base_url 的形态与主站域名不同，请从控制台「快速开始 / API 文档」页复制，一般以 /v1 结尾，调用路径为 /chat/completions。

1. 写入环境变量

把控制台复制的地址和密钥放进环境变量，避免硬编码进代码：

export ROUTEWAY_BASE_URL="从控制台快速开始页复制的 base_url，末尾带 /v1"
export ROUTEWAY_API_KEY="在控制台密钥页新建的 API Key"

2. 用 curl 发一次对话补全

curl "$ROUTEWAY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $ROUTEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "此处填控制台模型列表中的 experimental 模型 ID",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手"},
      {"role": "user", "content": "用一句话说明什么是 OpenAI 兼容接口"}
    ],
    "max_tokens": 256,
    "temperature": 0.7,
    "stream": false
  }'

3. 用 Python 的 openai SDK 调用

安装好 openai 库后，只需替换 base_url 与密钥即可复用原有代码：

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ["ROUTEWAY_BASE_URL"],
    api_key=os.environ["ROUTEWAY_API_KEY"],
)

resp = client.chat.completions.create(
    model="此处填控制台模型列表中的 experimental 模型 ID",
    messages=[
        {"role": "system", "content": "你是一个简洁的助手"},
        {"role": "user", "content": "你好，做一次连通性测试"},
    ],
    max_tokens=256,
    temperature=0.7,
)
print(resp.choices[0].message.content)

4. 关键参数说明

• model：必填。免费档只能填 experimental 模型 ID，从控制台模型列表复制；写错会直接返回模型不存在的错误。
• messages：必填。按 role 与 content 传数组，system 放指令，user 放问题。
• max_tokens：输出长度上限。免费档建议压在 256 到 512，避免单次请求消耗过多 tokens。
• temperature：随机性参数，做连通性测试用 0 到 0.7 即可。
• stream：设为 true 走流式返回，客户端需按服务端事件流逐块解析。

5. 额度耗尽与限流的典型表现

最常见的是 HTTP 429：可能是一天的 200 次请求用完了，也可能是并发超过免费档限制，两者现象很像，要靠控制台用量页区分。返回 401 一般是密钥错误或被吊销；返回模型不存在，通常是 model 不在免费档清单里；返回 5xx 或超时，则是共享低优先级队列的尽力而为特性导致，重试或错峰即可。

1. 先看控制台用量页：当天请求次数是否已经到 200 次。到了就只能等刷新，刷新时间以控制台显示为准。
2. 再确认没有并发：免费档限单并发，把脚本里的多线程、批量任务改成串行重试一次。
3. 检查请求头：Authorization: Bearer 密钥 是否完整，密钥前后有没有多余空格或换行。
4. 检查 URL：base_url 是否以 /v1 结尾，拼接后是否为 /v1/chat/completions，不要重复加或漏掉版本段。
5. 检查模型：model 是否来自控制台免费档列表，是否误填了需要 Core 套餐才能用的模型。
6. 以上都正常但仍偶发失败，属共享队列的正常波动，加一次退避重试即可；需要稳定吞吐或完整模型时升级到 Core。