Requesty 免费 AI API 路由：每日刷新 200 次请求额度，可接入 Cline 与 Cursor 等编程助手

Requesty 的接口遵循 OpenAI 兼容规范，base_url 形如 https://router.requesty.ai/v1，实际地址请以控制台「API 集成」页给出的为准。模型名采用「厂商/模型」的完整形式，例如 openai/gpt-4o-mini 或 anthropic/claude-3-5-sonnet，完整可用列表在控制台的模型页查看。

先把密钥与地址写入环境变量，方便后续命令直接复用：

export REQUESTY_API_KEY="sk-在控制台生成的密钥"
export REQUESTY_BASE_URL="https://router.requesty.ai/v1"

然后用 curl 发起一次最小的对话补全请求，验证密钥与模型是否可用：

curl "$REQUESTY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $REQUESTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {"role": "system", "content": "你是一个简洁的助手"},
      {"role": "user", "content": "用一句话解释什么是 API 网关"}
    ],
    "temperature": 0.7,
    "max_tokens": 256,
    "stream": false
  }'

关键参数说明：model 必须填控制台列出的完整模型名，写简写会直接报错；messages 是对话数组，按 system、user、assistant 的顺序追加历史；temperature 控制随机性，调试时建议调低；max_tokens 限制回复长度，免费档建议调小以节省请求与用量；stream 设为 true 可流式返回，适合接入编程助手的实时输出。在 Cline、Cursor 等工具里接入时，选择 OpenAI 兼容或自定义提供商，把 base_url 与密钥填入对应输入框即可。

用 Python 官方 SDK 调用同样只需替换 base_url 与模型名：

from openai import OpenAI

client = OpenAI(
    api_key="sk-在控制台生成的密钥",
    base_url="https://router.requesty.ai/v1",
)

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "写一句测试文案"}],
    max_tokens=128,
)
print(resp.choices[0].message.content)

额度耗尽或限流的典型表现：接口返回 HTTP 429，响应体提示请求次数超限、速率过快或余额不足；编程助手里则表现为长时间转圈后弹出报错，或直接退回本地模型。排查可按下面的顺序进行：

1. 核对密钥是否有效，请求头是否写成 Authorization: Bearer 密钥，注意中间的空格。
2. 检查 base_url 是否缺少或多写了 /v1，以及结尾是否多了斜杠导致路径拼接错误。
3. 确认模型名是控制台列出的完整名称，而不是厂商的简写或别名。
4. 打开控制台用量页，看当日请求数是否已达每日上限，若已达则等次日额度刷新后再试。
5. 降低并发数与自动重试频率，短时间密集请求容易触发速率限制，可加指数退避后重试。
6. 换一个模型再请求一次，用于判断是单个模型暂不可用，还是账号整体受限。