Free.ai 聚合平台免费额度申请指南：每日 3 万 tokens 的 OpenAI 兼容接口

Free.ai 的接口协议与 OpenAI 一致，已有代码基本只需替换 base_url、API Key 和模型名三项，不必改动请求结构。

base_url 与模型名从哪里取

接口地址在控制台的接口文档或调用示例页给出，形态通常是以 /v1 结尾的地址，请原样复制，不要自己拼接路径或漏掉 /v1。可用模型名以控制台「模型列表」为准，免费额度只覆盖其中标注为自托管（self-hosted）的模型，其余模型不在免费范围内。

先设置环境变量

export FREE_AI_BASE_URL="控制台文档里给出的接口地址"
export FREE_AI_API_KEY="控制台生成的 API Key"

一次对话补全调用

下面这条 curl 命令把环境变量拼接成完整请求，model 字段请替换成控制台模型列表中的自托管模型名。

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

用 Python 的 requests 库调用时，请求体结构完全一致，注意捕获状态码方便排查：

import os
import requests

resp = requests.post(
    os.environ["FREE_AI_BASE_URL"] + "/chat/completions",
    headers={"Authorization": "Bearer " + os.environ["FREE_AI_API_KEY"]},
    json={
        "model": "控制台模型列表中的自托管模型名",
        "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己"}],
        "temperature": 0.7,
        "max_tokens": 128,
        "stream": False,
    },
    timeout=60,
)
print(resp.status_code)
print(resp.text)

关键参数说明

• model：必填，取控制台模型列表里的名字，免费额度只对自托管模型生效。
• messages：必填，数组形式，每项含 role（system、user、assistant）与 content 两个字段。
• temperature：采样随机度，取值区间常见为 0 到 2，写代码类任务建议调低。
• max_tokens：限制回复长度，也是控制免费 token 消耗最直接的手段，建议先设小值试跑。
• stream：设为 true 时按流式逐块返回，客户端需要按 SSE 方式解析，不支持会导致空响应。
• top_p、stop：可选参数，与 OpenAI 语义一致，不必与 temperature 同时调整。

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

• 返回 429：多为超过每分钟请求上限或当天的免费 token 已用尽，响应体会给出限流提示，等刷新后再试或降低并发。
• 返回 401：密钥缺失、写错或已被删除，重点检查 Authorization 头是否带 Bearer 前缀。
• 返回 404 或 400 并提示模型不存在：模型名拼错，或误用了不在免费范围的非自托管模型。
• 返回 402 或 403：账户权限或额度不足，需要回控制台查看用量面板。

排查顺序建议

1. 先看 HTTP 状态码，把网络错误和业务错误分开。
2. 核对 base_url 是否与控制台示例完全一致，尤其是否漏了 /v1。
3. 核对 model 是否为当前可用的自托管模型名。
4. 核对密钥是否有效、是否带了 Bearer 前缀。
5. 进控制台用量面板确认当日 token 与每分钟请求是否触顶。
6. 最后再排查并发与重试策略，建议对 429 做指数退避，不要高频重试，否则会持续触顶。