OpenAI 兼容客户端

本页适用于支持自定义 OpenAI-compatible Base URL 与 API Key 的客户端、SDK 或内部工具。它是通用手动配置路径，不代表任何第三方产品获得官方认证或其可选功能均已验证。

开始前

从目标客户端的官方渠道安装适用于 Windows、macOS 或 Linux 的当前版本。创建单独 API Key，获取其实际模型清单：

curl 'https://ai.tavonilo.com/v1/models' \
  -H "Authorization: Bearer $AI_SHOP_API_KEY"

只使用返回的 data[].id，并把 Key 放在系统凭据存储、环境变量或部署平台 Secret 中。

标准配置

字段	值
Base URL	https://ai.tavonilo.com/v1
API Key	独立 API Key
Model	当前 /v1/models 返回的模型 ID
首选请求	POST /v1/responses 或 POST /v1/chat/completions

Python SDK 的最小验证：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-own-key",
    base_url="https://ai.tavonilo.com/v1",
)
result = client.chat.completions.create(
    model="<MODEL_ID>",
    messages=[{"role": "user", "content": "Reply with connected."}],
)
print(result.choices[0].message.content)

恢复与安全

• 401：检查 Bearer Key 与 Secret 注入。
• 403：检查 Key 的分组、模型、余额和路由权限。
• 404：Base URL 不应包含完整请求路径，也不能出现 /v1/v1。
• 429：使用客户端队列、退避和限流。
• 5xx：只安全重试，记录脱敏请求 ID 和时间。

对于 Anthropic Messages 使用不同的根 Base URL 和认证头，请改看 Claude Code 或 Messages API。