BazaarLink 免费 API 教程：auto:free 自动路由零成本模型，每日刷新额度

BazaarLink 兼容 OpenAI 的接口格式，只要把 base_url 换成平台地址、把 Key 换成自己的，原来的 SDK 代码基本不用改。控制台文档里给出的地址通常形如 https://bazaarlink.ai/v1，以控制台实际显示为准。

1. 先配置环境变量

把 Key 放进环境变量，避免硬编码到代码和仓库里：

export BAZAARLINK_API_KEY="粘贴你在控制台创建的 Key"

2. 用 curl 发一次对话补全

下面的请求直接调用对话补全接口，模型用 auto:free 交由网关自动挑选：

curl https://bazaarlink.ai/v1/chat/completions \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto:free",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是 OpenAI 兼容接口"}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'

关键参数说明：model 填 auto:free 让网关自动路由到当前零成本模型，也可以直接写具体免费模型名，例如 Qwen3.7 Flash、Beam Free、Nemotron 3.5 Lightning Free、DeepSeek V4 Flash 0731 Free，完整列表在控制台模型页查看，或调用 /v1/models 获取；messages 是对话数组，最简写法只放一条 user 消息，system 提示词放在数组第一条即可；temperature 控制随机性，调试阶段保持 0.7 左右；max_tokens 限制回复长度，免费层建议压小以降低触发限流的概率；需要流式输出时再加 "stream": true。更换 base_url 后，同一个 Key 也能调用图像、视频、语音转写接口，模型名同样从控制台获取。

3. 用 Python SDK 调用

安装官方 openai 包后，把 base_url 指向平台即可复用原有写法：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["BAZAARLINK_API_KEY"],
    base_url="https://bazaarlink.ai/v1",
)

resp = client.chat.completions.create(
    model="auto:free",
    messages=[{"role": "user", "content": "你好，简单介绍一下你自己"}],
    temperature=0.7,
    max_tokens=256,
)

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

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

免费层出问题一般表现为：返回 429 并带 rate limit 或额度相关提示，回复明显变慢，或者请求被直接拒绝；额度用尽时也可能返回额度不足的报错文本，具体文案以控制台与接口返回为准。按下面顺序排查：

1. 先核对请求地址与鉴权：base_url 是否带对了版本路径、Authorization 头是否为 Bearer 加 Key，401 大多出在这里。
2. 核对 model 拼写：auto:free 中间是冒号，写成下划线或短横线都会失败，具体模型名要与控制台列表一致。
3. 打开控制台用量看板，确认当天调用次数是否已达每日上限、是否触发约 10 RPM 的速率限制，以及预算熔断是否把请求拦下。
4. 降低并发并加退避重试：命中 429 后等待 2 秒、4 秒、8 秒再重试，不要在循环里立刻重发。
5. 额度按日刷新，可等次日恢复或临时切换到其他免费模型；长期不够用再考虑付费模型。

下图是平台官网概览，进入控制台后可以查看用量看板与预算设置。