Api.Airforce 免费档每日 1000 次调用，免绑卡多协议聚合网关

拿到密钥后，接入方式与 OpenAI 完全一致：OpenAI 兼容端点为 https://api.airforce/v1，Anthropic 与 Gemini 兼容端点的具体路径请以控制台文档为准。建议先把密钥写入环境变量，避免在代码里硬编码。

export AIRFORCE_API_KEY="粘贴控制台生成的密钥"

第一步：确认可用模型名。免费档只放开基础模型，可用名称以控制台模型列表或 /v1/models 返回为准，不要凭记忆乱填高阶模型名，否则会直接返回权限不足或余额不足。

curl https://api.airforce/v1/models \
  -H "Authorization: Bearer $AIRFORCE_API_KEY"

第二步：发一次对话补全请求。关键参数有四个：model 填模型列表里存在的基础模型名；messages 是对话数组，必须带 role 与 content；temperature 控制随机性；max_tokens 限制回复长度，免费档建议调小。把下面的模型名换成你实际查到的名称即可。

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

第三步：换成 Python 调用。沿用 OpenAI 官方 SDK，只改 base_url 与 api_key 两处即可，其余写法和官方一致。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIRFORCE_API_KEY"],
    base_url="https://api.airforce/v1"
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好，做个自我介绍"}],
    temperature=0.7,
    max_tokens=256,
    stream=False
)

print(resp.choices[0].message.content)

额度耗尽与限流的典型表现：突发连续请求会返回 429 Too Many Requests，说明撞上了免费档每分钟 1 次的频率限制；当天次数用完后通常返回 402 或 403 之类与配额、余额相关的错误；密钥错误或缺失则是 401；模型名超出免费范围时，会提示无权访问该模型。高峰期网关在多个渠道间自动故障转移，也可能出现 5xx 或超时。

排查顺序：先确认 Authorization 头里的密钥是否完整、是否多了空格；再检查 base_url 是否写成 https://api.airforce/v1 而不是别的路径；然后调 /v1/models 核对模型名是否在免费档内；接着给请求加上间隔、串行发送，排除频率问题；最后看控制台用量面板，确认当日额度是否已经用完。额度按天刷新，第二天自动恢复。