Token Harbor 免费额度指南：7 天滚动刷新、免绑卡与限流说明

Token Harbor 是同时兼容 OpenAI 与 Anthropic 两种格式的网关，一把密钥可以用两种 SDK 调用。base_url 与控制台给出的示例保持一致，常见形态是 https://tokenharbor.ai/v1，以控制台接入文档为准。

一、准备密钥与环境变量

先把密钥和 base_url 放进环境变量，避免硬编码进代码：

export TOKEN_HARBOR_KEY="控制台创建的 API Key"
export OPENAI_BASE_URL="https://tokenharbor.ai/v1"

二、确认可用模型

免费路由目前包含 DeepSeek V4.1 Flash、MiMo V2.6 Flash、TH-Rudder 等模型。请求里的 model 字段要填控制台模型列表给出的模型 ID，而不是界面上显示的模型名称。

三、发一次对话补全请求

下面是最小可运行的 curl 示例。关键参数：model 选免费路由内的模型；messages 传对话数组，可含 system 与 user 角色；max_tokens 限制输出长度，免费额度按模型标价折算，输出越长消耗越多；temperature 控制随机性。

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN_HARBOR_KEY" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "system", "content": "你是一位简洁的中文助手"},
      {"role": "user", "content": "用一句话说明什么是 API 网关"}
    ],
    "max_tokens": 256,
    "temperature": 0.7
  }'

用 Python SDK 调用只需替换 base_url 与密钥：

from openai import OpenAI

client = OpenAI(
    api_key="控制台创建的 API Key",
    base_url="https://tokenharbor.ai/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "你好"}],
    max_tokens=256,
    temperature=0.7,
)
print(resp.choices[0].message.content)

四、在 Claude Code 里走 Anthropic 格式

网关兼容 Anthropic 格式，Claude Code 可以直接指向它，地址与控制台接入示例保持一致：

export ANTHROPIC_BASE_URL="https://tokenharbor.ai"
export ANTHROPIC_AUTH_TOKEN="控制台创建的 API Key"
claude

五、限流与额度耗尽的排查顺序

典型表现：返回 429 或提示 rate limit，说明触碰了 60 次/分钟、1,800 次/小时 的频率上限；返回 401 或 403，多为密钥无效、未开启免费路由；提示模型不存在，多半是 model 填了展示名；请求能通但控制台百分比不动或直接拒绝，则是滚动窗口内的免费额度用完了。

排查顺序建议：先确认控制台免费路由开关已打开，再核对密钥与 base_url 是否抄错，接着检查模型 ID 是否在免费路由列表内，然后看额度百分比与小时用量，最后降低并发并加指数退避重试，等滚动窗口恢复。免费额度按 7×24 小时滚动计算，官方保留调整权利，不承诺长期固定数值。