APInex 免费模型网关：每日 2000 万 tokens 额度申请与调用全流程

APInex 提供 OpenAI 兼容接口，base_url 形如 https://apinex.bond/v1（具体地址以控制台文档为准）。把原来指向官方的 base_url 换成它，密钥换成控制台生成的 Key，原有 SDK 基本不用改代码。

目前带 free/ 前缀的免费模型有 free/gpt-6-luna、free/deepseek-v4.1-flash、free/gemini-3.8-flash。完整模型列表请以控制台或模型列表接口的显示为准；调用时模型名要一字不差地带上前缀。

方式一：用 curl 快速验证

先把密钥写入环境变量，避免密钥出现在命令历史里：

export APINEX_API_KEY="sk-你的密钥"
export APINEX_BASE_URL="https://apinex.bond/v1"

然后发一次对话补全请求：

curl "$APINEX_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $APINEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "free/deepseek-v4.1-flash",
    "messages": [
      {"role": "system", "content": "你是一个简洁的技术助手"},
      {"role": "user", "content": "用一句话说明什么是向量数据库"}
    ],
    "max_tokens": 256,
    "temperature": 0.7,
    "stream": false
  }'

关键参数说明：model 必填，只有带 free/ 前缀的模型名才走每日免费额度；messages 是对话数组，支持 system、user、assistant 三种角色；max_tokens 限制单次输出长度，跑批量脚本时建议调小以节省额度；temperature 控制输出的随机程度；stream 设为 true 可流式返回，适合长文本输出。

方式二：用 Python SDK 调用

安装官方 openai 库后，只需替换 base_url 与 api_key：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://apinex.bond/v1",
)

resp = client.chat.completions.create(
    model="free/gpt-6-luna",
    messages=[{"role": "user", "content": "写一个 Python 快速排序示例"}],
    max_tokens=512,
    temperature=0.7,
)
print(resp.choices[0].message.content)

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

遇到报错时，建议按下面的顺序逐项排查：

1. 返回 401 未授权：密钥错误、已失效，或请求头缺少 Authorization: Bearer 前缀，先到控制台核对 Key 状态。
2. 返回 404 模型不存在：模型名拼写错误或漏了 free/ 前缀，对照控制台模型列表核对完整名称。
3. 返回 429 请求过多：触发了并发或速率限制，降低并发数、在脚本中加入指数退避重试，批量任务改为串行或小并发。
4. 提示余额或额度不足：当天的 2000 万 tokens 已经用完，或误调了付费模型导致钱包余额不足；可等次日额度重置，或到控制台用量明细里确认消耗来源。
5. 超时或返回 5xx：第三方网关偶发不稳定，重试仍失败时切换到官方直连或其他备用渠道，生产环境务必备好降级路径。