跳转到主要内容

​
常见错误现象

当您看到类似以下错误信息时： 
{
  "error": {
    "message": "Incorrect API key provided: sk-QqHvK***...",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}
这通常不是您的 API Key 本身有问题，而是请求地址（Base URL）配置错误导致的。
最常见的错误：使用了 API易 的 Key，但请求地址仍然指向 OpenAI 官网 https://api.openai.com

​
什么是 Base URL？

Base URL（基础 URL / 请求地址）是 API 请求的目标服务器地址。不同的 API 服务提供商使用不同的 Base URL。

​
Base URL 和 API Key 必须一一对应

服务提供商Base URLAPI Key 格式是否匹配
API易https://api.apiyi.comsk-xxxx......✅ 正确
OpenAI 官方https://api.openai.comsk-xxxx......✅ 正确
❌ API易 Keyhttps://api.openai.comsk-xxxx......❌ 错误
❌ OpenAI Keyhttps://api.apiyi.comsk-xxxx......❌ 错误
关键原则：使用哪家的 API Key，就必须将请求发送到对应服务商的 Base URL。

​
正确的配置方法

​
方法一：修改 Base URL（推荐）

只需将请求地址从 OpenAI 官网替换为 API易，其他代码完全不变： 
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-apiyi-key",  # API易后台获取的Key
    base_url="https://api.apiyi.com/v1"  # 改为API易地址
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}]
)

​
方法二：使用环境变量

设置环境变量后，代码中无需显式指定 Base URL： 
export OPENAI_API_KEY="sk-your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

​
API易支持的请求地址格式

根据您的代码情况，API易支持以下三种 Base URL 格式：
  • 格式 1：带 /v1（推荐）
  • 格式 2：带 /v1/（末尾有斜杠）
  • 格式 3：完整路径
https://api.apiyi.com/v1
适用场景：大多数代码库默认会在 Base URL 后自动添加具体路径完整请求示例：
https://api.apiyi.com/v1/chat/completions
https://api.apiyi.com/v1/models

​
常见问题排查

可能原因：
  1. 代码中有多处配置：检查是否在配置文件、环境变量、代码初始化等多处都设置了 Base URL
  2. 使用了代理或中间件：某些代理工具可能会重定向请求
  3. 缓存问题：重启程序或清除缓存后重试
  4. 拼写错误：确认 apiyi 拼写正确（不是 apiyii 或 apiyl）
在 API易 后台查看：
  1. 登录 API易 后台 console.apiyi.com
  2. 进入「令牌」页面
  3. 检查 Key 状态是否为「启用」
  4. 确认账户余额充足
大多数第三方工具都有「自定义 API」或「自建服务器」选项：
  • API 地址 / Base URL：https://api.apiyi.com/v1
  • API Key：从 API易 后台复制您的 Key
  • 模型名称：参考 API易 文档中的模型列表
具体配置位置可能在「设置」→「API」或「服务器」等选项中
API易 提供了多种语言的完整代码示例：
  1. 快速开始文档：文档首页 → 代码示例
  2. 在线测试工具：后台 → ApiFox 在线测试
  3. GitHub 仓库：github.com/apiyi/docs → knowledge-base 目录

​
错误示例 vs 正确示例

❌ 错误配置

client = OpenAI(
    api_key="sk-apiyi-key",
    base_url="https://api.openai.com/v1"
    # ❌ 使用了OpenAI官网地址
)
结果：OpenAI 服务器会拒绝 API易 的 Key

✅ 正确配置

client = OpenAI(
    api_key="sk-apiyi-key",
    base_url="https://api.apiyi.com/v1"
    # ✅ 使用API易地址
)
结果：请求成功发送到 API易 服务器

​
快速测试方法

使用 cURL 命令快速验证配置是否正确： 
curl https://api.apiyi.com/v1/models \
  -H "Authorization: Bearer sk-your-apiyi-key"
预期结果：返回可用模型列表 
{
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      ...
    }
  ]
}
如果返回错误，请检查：
  1. API Key 是否正确复制（注意首尾空格）
  2. 网络连接是否正常
  3. 账户余额是否充足

​
相关文档

记住核心原则：哪家的 Key 配哪家的 URL，API易 的 Key 就用 https://api.apiyi.com/v1