Vercel AI Gateway 免费层每 30 天 5 美元额度：领取步骤与接口调用指南

Vercel AI Gateway 提供 OpenAI 兼容接口，base_url 的形态是 https://ai-gateway.vercel.sh/v1，把官方 SDK 的 base_url 指到它，再用 AI Gateway 生成的密钥替换 api_key，就能直接复用现有的 OpenAI 调用代码。模型名采用「供应商/模型」的写法，例如 openai/gpt-4o-mini、anthropic/claude-sonnet-4，具体可用名称与是否属于免费层，以控制台模型列表的标注为准。

先设置环境变量，避免密钥硬编码进代码：

export AI_GATEWAY_API_KEY='替换为控制台创建的密钥'

然后用 curl 发一次最简的对话补全请求：

curl https://ai-gateway.vercel.sh/v1/chat/completions \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是 API 网关"}
    ],
    "max_tokens": 256,
    "temperature": 0.7
  }'

关键参数说明：model 必须是控制台列出的模型名，写成供应商前缀加模型标识；messages 是消息数组，role 取 user、assistant、system；max_tokens 控制回复长度，直接影响扣费多少；temperature 调节随机性；需要流式输出时加 "stream": true，响应会以 SSE 分块返回。

在 Python 项目里，用官方 OpenAI SDK 改两行即可切换过来：

from openai import OpenAI

client = OpenAI(
    api_key="替换为控制台创建的密钥",
    base_url="https://ai-gateway.vercel.sh/v1",
)

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "写一句产品简介"}],
    max_tokens=256,
)
print(resp.choices[0].message.content)

额度耗尽或限流的典型表现与排查顺序

1. 先看错误码：返回 429 通常是速率限制或额度不足；返回 401 是密钥错误或已被删除；返回 403 或提示模型不可用，多半是该模型不在免费层范围内。
2. 核对模型是否 Free Tier eligible：把出错请求里的模型名换成一个明确标注免费层可用的模型重试，如果能通，说明是模型选错而不是额度问题。
3. 查控制台用量：在 AI Gateway 的用量页面看当前周期已消耗额度与剩余额度，额度是否已用尽、何时重置，以控制台实际显示为准。
4. 降低并发与频率：免费层速率限制较低，把并发压到个位数、请求之间加几百毫秒间隔，并对 429 做指数退避重试。
5. 检查网络与区域：确认请求地址拼写正确、没有多余的路径段，本地被代理拦截时换网络环境再试一次。