使用帮助

接入即用 · OpenAI 兼容

01 · 获取网关 Token

登录后在使用面板点击「重置」,即会生成唯一的 sk- Token,更换任意厂商上游地址即可使用。Token 仅展示一次,无法找回。

02 · curl 调用

bash
curl https://freeai-gateway.YOUR-SUBDOMAIN.workers.dev/v1/chat/completions \
  -H "Authorization: Bearer sk-你的网关Token" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"你好"}]}'

03 · Python (OpenAI SDK)

python
from openai import OpenAI
client = OpenAI(
    base_url="https://freeai-gateway.YOUR-SUBDOMAIN.workers.dev/v1",
    api_key="sk-你的网关Token",
)
resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

04 · JavaScript (fetch)

js
const resp = await fetch(
  "https://freeai-gateway.YOUR-SUBDOMAIN.workers.dev/v1/chat/completions",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer sk-你的网关Token",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "gpt-4o-mini",
      messages: [{ role: "user", content: "你好" }],
    }),
  },
);
const data = await resp.json();
console.log(data.choices[0].message.content);

05 · 配额与限制

  • 每日调用与 Token 分级(信誉 80+ → 100 次/300k Token,最低档 3 次/天永不归零)
  • 新用户注册 7 天内配额减半
  • 提交渠道的贡献者可获得每日 +10 ~ +100 调用次数加成
  • 所有请求走自动故障转移与熔断,尽可能保证请求成功

06 · 异常排查

  • 401 invalid_token:Token 已被重置或无效,重新登录获取
  • 429 quota_exceeded:今日额度用完,明日自动恢复
  • 503 pool_empty:当前模型无可用渠道,稍后再试或贡献新渠道
  • 503 预算保护:全站动态服务按免费额度保护,UTC 00:00 自动恢复