跳转到主要内容

​
快速答案

一句话记住：OpenAI 系列加 /v1，Claude 只填根域名，Gemini 加 /v1beta。填错 Base URL 是最常见的接入问题。
模型系列Base URL适用 SDK
GPT / DeepSeek / Llama / Qwen 等https://api.apiyi.com/v1OpenAI SDK
Claude 系列https://api.apiyi.comAnthropic SDK
Gemini 系列https://api.apiyi.comGoogle 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易 提供 4 个域名节点，功能完全一致，区别在于网络线路和部署架构：

🌏 全球直连（推荐海外客户）

vip.apiyi.com直连大后端，延迟最低。全球客户（非中国大陆）首选推荐。

🇨🇳 国内默认（推荐大陆客户）

api.apiyi.com国内优化线路，中国大陆客户默认推荐。

🏢 国内备用 / 企业专用

b.apiyi.comBackup 备用节点，同时也是 Business 企业专用线路。主力节点异常时可切换。

⚡ Cloudflare CDN 全球加速

api-cf.apiyi.comCloudflare 全球 CDN 加速，适合纯文本类调用。有 100 秒超时限制。
节点域名推荐客户说明
全球直连vip.apiyi.com非中国大陆客户直连后端，延迟最低
国内默认api.apiyi.com中国大陆客户国内优化线路（默认）
国内备用/企业b.apiyi.com企业客户 / 备用Backup + Business
Cloudflare CDNapi-cf.apiyi.com仅文本类调用全球加速，100 秒超时限制
Cloudflare CDN 节点限制：api-cf.apiyi.com 基于 Cloudflare Workers 部署，最大请求超时为 100 秒。因此：
  • ✅ 适合：普通文本对话、短文本生成等快速响应的调用
  • ❌ 不适合：超过 100 秒的复杂长文本任务
  • ❌ 不适合：Nano Banana Pro 等图片生成任务
  • ❌ 不适合：视频生成 API 调用
如果你的任务可能超过 100 秒，请使用 vip.apiyi.com（海外）或 api.apiyi.com（国内）。
建议在代码中配置备用节点，实现自动切换，提高服务可用性。

​
常见报错排查

报错可能原因解决方法
404 Not FoundOpenAI SDK 漏加 /v1，或 Anthropic SDK 多加了 /v1检查路径是否匹配 SDK 规范
400 Bad RequestGemini SDK 路径版本不匹配确认使用 /v1beta
连接超时域名节点选择不当国内用 api.apiyi.com，海外用 vip.apiyi.com；CF-CDN 节点有 100 秒超时限制
SSL 错误缺少 https:// 前缀所有节点必须使用 HTTPS
双斜杠错误base_url 末尾多了 /去掉末尾斜杠

​
完整配置速查

​
OpenAI 兼容模型

节点Base URL
全球直连（海外推荐）https://vip.apiyi.com/v1
国内默认（大陆推荐）https://api.apiyi.com/v1
国内备用/企业https://b.apiyi.com/v1
Cloudflare CDN（仅文本）https://api-cf.apiyi.com/v1

​
Claude 模型（Anthropic SDK）

节点Base URL
全球直连（海外推荐）https://vip.apiyi.com
国内默认（大陆推荐）https://api.apiyi.com
国内备用/企业https://b.apiyi.com
Cloudflare CDN（仅文本）https://api-cf.apiyi.com

​
Gemini 模型

节点Base URL
全球直连（海外推荐）https://vip.apiyi.com
国内默认（大陆推荐）https://api.apiyi.com
国内备用/企业https://b.apiyi.com
Cloudflare CDN（仅文本）https://api-cf.apiyi.com
Gemini 使用 Google GenAI SDK 时，base_url 填根域名，同时设置 api_version: "v1beta"，SDK 会自动拼接完整路径。