七牛云 AI 平台接入 50+ 模型：实名认证每日领 1 亿免费 Token

七牛云 AI 是聚合型网关，一个 Key 可以调用 Qwen、DeepSeek、Kimi、GLM、MiniMax、豆包等 50 多个模型，同时兼容 OpenAI 与 Anthropic 两套协议。已有 OpenAI SDK 的项目，通常只要改 base_url 和 api_key 两行就能跑通。

Base URL 与模型名

平台提供 OpenAI 兼容与 Anthropic 兼容两种接入地址，前者形状为 https://<接入域名>/v1，后者形状为 https://<接入域名>，实际域名以控制台「接入指南 / API 文档」页显示的为准。接 Claude Code 这类客户端时，改的是 ANTHROPIC_BASE_URL 环境变量。

模型 ID 不要凭记忆拼写，去控制台模型列表页复制完整 ID；下面示例里的 deepseek-chat 仅作格式示范，请替换成列表中真实存在的那一项。

第一步：写入环境变量

export QINIU_API_BASE="https://<接入域名>/v1"
export QINIU_API_KEY="sk-替换为你的密钥"

把这两行放进 ~/.zshrc 或项目的 .env 文件，避免把密钥硬编码进代码仓库。

第二步：用 curl 发一次对话补全

curl "$QINIU_API_BASE/chat/completions" \
  -H "Authorization: Bearer $QINIU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是向量数据库"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

返回体结构与 OpenAI 一致，正文在 choices[0].message.content 里。

第三步：用 Python SDK 调用

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["QINIU_API_KEY"],
    base_url=os.environ["QINIU_API_BASE"],
)

resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "写一段 50 字的产品简介"}],
    temperature=0.7,
    max_tokens=512,
)

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

关键参数说明

• model：必填，控制台模型列表中的完整 ID，决定实际调用哪家厂商的模型以及是否走免费额度。
• messages：必填，消息数组，role 取 system、user、assistant，content 为文本内容。
• max_tokens：限制单次输出的最大长度，设得过小会导致回答被截断。
• temperature：控制随机性，取值 0 到 1，问答和代码类任务建议 0.3 到 0.7。
• stream：设为 true 时按流式返回，适合接入聊天界面做打字机效果。

额度耗尽与限流的排查顺序

1. 先看返回体的错误码与 message：出现配额或额度相关提示，说明当天免费 Token 已用完，请求被直接拒绝、不会扣账户余额，等次日刷新即可，反复重试没有意义。
2. 返回 401 或 403：检查请求头是否为 Authorization: Bearer <你的 Key>，Key 是否被删除，复制时是否带了多余空格。
3. 返回 404 或提示模型不存在：核对 model 字段与控制台列表是否完全一致，以及 base_url 是否漏掉 /v1。
4. 返回 429：多为并发或频率限制，降低并发数、加入指数退避重试后再试。
5. 请求正常但拿不到内容：确认实名认证是否已通过，以及活动是否已在 11 月 30 日结束、账号是否已转入按量计费模式。