快速答案
一句话记住：OpenAI 系列加 /v1，Claude 只填根域名，Gemini 加 /v1beta。填错 Base URL 是最常见的接入问题。
| 模型系列 | Base URL | 适用 SDK |
|---|
| GPT / DeepSeek / Llama / Qwen 等 | https://api.apiyi.com/v1 | OpenAI SDK |
| Claude 系列 | https://api.apiyi.com | Anthropic SDK |
| Gemini 系列 | https://api.apiyi.com | Google GenAI SDK（需设置 api_version: "v1beta"） |
为什么不同模型的 Base URL 不一样？
这是由各厂商 SDK 的内部实现决定的：
- OpenAI SDK：在
base_url 后拼接资源路径，所以需要包含 /v1
- Anthropic SDK：内部自动拼接
/v1/messages，如果你填了 /v1 会变成 /v1/v1/messages，导致 404 错误
- Google GenAI SDK：使用
/v1beta 路径，SDK 自动处理路径拼接
代码示例
OpenAI 兼容模型（GPT / DeepSeek / Llama 等）
import openai
client = openai.OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com/v1" # 域名 + /v1
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "你好！"}]
)
print(response.choices[0].message.content)
Claude 模型（Anthropic SDK）
import anthropic
client = anthropic.Anthropic(
api_key="YOUR_API_KEY",
base_url="https://api.apiyi.com" # 只填根域名，不要加 /v1
)
message = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
messages=[{"role": "user", "content": "你好！"}]
)
print(message.content[0].text)
Gemini 模型（Google GenAI SDK）
from google import genai
client = genai.Client(
api_key="YOUR_API_KEY",
http_options={"api_version": "v1beta", "base_url": "https://api.apiyi.com"}
)
response = client.models.generate_content(
model="gemini-2.5-pro",
contents="你好！"
)
print(response.text)
Claude 用户常见错误：如果你用 Anthropic 官方 SDK 调用 Claude，Base URL 只填 https://api.apiyi.com，千万不要加 /v1。但如果你用 OpenAI SDK 的兼容模式调用 Claude，则需要加 /v1。
域名节点选择
API易 提供 3 个域名节点，功能完全一致，区别仅在于网络线路优化：
| 节点 | 域名 | 适用场景 |
|---|
| 国内主力 | api.apiyi.com | 国内服务器、本地开发（推荐首选） |
| 国内备用 | b.apiyi.com | 主力节点异常时切换 |
| 海外专用 | vip.apiyi.com | 海外服务器部署 |
建议在代码中配置备用节点，实现自动切换，提高服务可用性。
常见报错排查
| 报错 | 可能原因 | 解决方法 |
|---|
| 404 Not Found | OpenAI SDK 漏加 /v1，或 Anthropic SDK 多加了 /v1 | 检查路径是否匹配 SDK 规范 |
| 400 Bad Request | Gemini SDK 路径版本不匹配 | 确认使用 /v1beta |
| 连接超时 | 域名节点选择不当 | 国内用 api.apiyi.com，海外用 vip.apiyi.com |
| SSL 错误 | 缺少 https:// 前缀 | 所有节点必须使用 HTTPS |
| 双斜杠错误 | base_url 末尾多了 / | 去掉末尾斜杠 |
完整配置速查
OpenAI 兼容模型
| 节点 | Base URL |
|---|
| 国内主力 | https://api.apiyi.com/v1 |
| 国内备用 | https://b.apiyi.com/v1 |
| 海外专用 | https://vip.apiyi.com/v1 |
Claude 模型（Anthropic SDK）
| 节点 | Base URL |
|---|
| 国内主力 | https://api.apiyi.com |
| 国内备用 | https://b.apiyi.com |
| 海外专用 | https://vip.apiyi.com |
Gemini 模型
| 节点 | Base URL |
|---|
| 国内主力 | https://api.apiyi.com |
| 国内备用 | https://b.apiyi.com |
| 海外专用 | https://vip.apiyi.com |
Gemini 使用 Google GenAI SDK 时，base_url 填根域名，同时设置 api_version: "v1beta"，SDK 会自动拼接完整路径。
