AI API 接入指南：Base URL、密钥与模型选择

1. 先确认账号与密钥

登录已有账号后，在控制台创建 API Key，并确认所属分组、可用额度和有效期。本站当前未开放自助注册；如果还没有账号，请先确认账号开通方式，再配置客户端。

密钥只保存在服务端环境变量或密钥管理系统中。浏览器前端代码、公开仓库和公开截图中都不应包含真实密钥。下面示例中的环境变量需要在你自己的环境中设置。

2. 区分 Base URL 和完整接口地址

有些客户端会自动追加 /v1，有些会自动追加接口路径。配置后检查最终 URL，避免出现 /v1/v1 或重复的 /chat/completions。如果客户端要求“完整接口地址”，就不能只填写域名。

3. 用当前密钥查询可用模型

curl --fail-with-body --silent --show-error \
  https://zzq.si/v1/models \
  -H "Authorization: Bearer ${ZEROTOKEN_API_KEY}"

从返回结果中选择实际可用且支持聊天补全的模型 ID，保存为 ZEROTOKEN_MODEL。不同密钥所属分组可能不同，不要仅凭其他用户的示例猜测模型名。模型展示名称也不一定等于接口所需的 ID。

4. 发出一个最小请求

以下命令需要 Python 3 和 cURL。它用 JSON 编码模型名，避免把环境变量直接拼进 JSON 字符串。该命令会发出一次真实模型请求，使用前请确认费用与额度。

python3 - <<'PY' | curl --fail-with-body --silent --show-error \
  https://zzq.si/v1/chat/completions \
  -H "Authorization: Bearer ${ZEROTOKEN_API_KEY}" \
  -H "Content-Type: application/json" --data-binary @-
import json, os
print(json.dumps({
    "model": os.environ["ZEROTOKEN_MODEL"],
    "messages": [{"role": "user", "content": "请用一句话介绍你自己。"}]
}, ensure_ascii=False))
PY

先检查 HTTP 状态和返回正文，再将相同配置迁入业务代码。不要在第一次测试时同时加入工具调用、图片和复杂输出格式，否则难以定位错误。

5. 迁移客户端时检查兼容范围

兼容接口并不代表所有模型支持完全相同的参数。确认模型是否支持图片、工具调用、结构化输出和流式输出；不支持的功能应在应用层禁用。Anthropic Messages、Responses 和 Gemini 原生接口使用各自的请求格式，不能只替换 URL 后继续发送 Chat Completions 请求体。

进一步阅读：快速开始、模型列表接口、API 参考。