跳到主要内容

OpenAI 兼容说明

彼源 AI 支持 OpenAI 兼容接入：多数情况下不用改现有代码，只调整几项配置就能切换过来。下面说明要改什么、覆盖哪些接口，以及常见的坑。

兼容结论​

对于大多数现有 OpenAI SDK 和支持自定义 OpenAI endpoint 的客户端，迁移至彼源 AI 时通常只需调整以下三项：

  • Base URL
  • API Key
  • model

但应注意，接口兼容并不表示与 OpenAI 官方所有原生产品行为完全一致。

迁移步骤​

1. 替换 Base URL​

将原 OpenAI 地址替换为：

https://api.biyuan.ai/v1

Base URL 不是某个接口的完整请求地址。客户端或 SDK 会在它后面继续拼接具体路径，例如：

填写类型应填写最终聊天请求地址
Base URLhttps://api.biyuan.ai/v1https://api.biyuan.ai/v1/chat/completions
完整端点 / Full URLhttps://api.biyuan.ai/v1/chat/completions直接使用该地址

应先确认客户端输入框要求的是 Base URL 还是完整端点。将 Base URL 填入 Full URL 输入框，可能导致请求只发送到 /v1；将完整端点填入会自动拼接路径的输入框，则可能出现重复的 /chat/completions/chat/completions。此外，部分客户端（如 NextChat、Cherry Studio）会自行拼接含 /v1 的完整路径，这类输入框应填写 https://api.biyuan.ai（不带 /v1），具体以对应客户端集成页说明为准。

2. 替换 API Key​

将原 OpenAI API Key 替换为彼源 AI 令牌。

3. 确认模型名称​

应确认当前填写的模型名称在当前分组和当前令牌下实际可见，而不应直接照搬其他环境中的模型配置。

OpenAI 兼容的常用路径​

以下路径都遵循 OpenAI 接口风格，可以直接用 OpenAI SDK 或兼容客户端调用（前缀为 Base URL https://api.biyuan.ai/v1）：

  • GET /models
  • POST /chat/completions
  • POST /completions
  • POST /responses、POST /responses/compact
  • POST /embeddings
  • POST /images/generations、POST /images/edits
  • POST /audio/transcriptions、/translations、/speech
  • POST /moderations
  • POST /videos、GET /videos/{task_id}

由此可见，兼容范围不只是聊天，还覆盖补全、Responses、嵌入、图片、音频和视频。完整的接口清单（含 Claude Messages、Rerank、实时等）见 API 概览。

API 兼容不等于客户端功能兼容​

彼源 AI 提供某条兼容接口，不代表每个客户端都提供了对应的配置入口。例如：

  • 仅支持 Chat Completions 的客户端，用不了 Responses 专属的模型
  • 自定义聊天入口通常不会去调用图片或音频接口
  • 客户端可能按模型名称切换服务商，或附加自己的默认参数
  • 客户端里「配置已保存」不代表它真的把请求发到了正确的端点

因此，排查时应把两个问题分开验证：

  1. 使用 curl 或 SDK 验证模型与 API 端点本身可用
  2. 再确认目标客户端是否支持同一协议、路径和模型能力

适配性较高的场景​

以下场景通常具有较高兼容性：

  • curl 验证
  • OpenAI 官方 SDK
  • 支持自定义 OpenAI 兼容地址的客户端
    例如 Cursor、Cherry Studio、Lobe Chat、Open WebUI、NextChat

兼容边界说明​

兼容的对象是接口协议与调用方式，而不是 OpenAI 官方整套产品行为。常见差异包括：

  • 可用模型名称不完全相同
  • 某些模型仅在指定分组内可见
  • 客户端可能附带自身默认参数
  • OpenAI 官方出品的部分应用（如 ChatGPT 客户端）不支持填第三方服务地址，无法接入彼源 AI

因此，更准确的理解方式是：

  • 支持自定义 Base URL 的工具（本站接入指南里的都算）才能接入彼源 AI，OpenAI 官方 SDK 也在此列
  • 不确定某个工具能不能接入时，看它的设置里有没有「自定义 API 地址 / Base URL」一栏；有就能填彼源 AI 的地址，没有（如 ChatGPT 客户端）就接不了

推荐验证方式​

建议先执行模型列表查询：

curl https://api.biyuan.ai/v1/models \
  -H "Authorization: Bearer <YOUR_TOKEN>"

再执行最小聊天请求：

curl https://api.biyuan.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "你好"}]
  }'

如以上两步均可正常完成，通常可判定 OpenAI 兼容主链路已经建立。

常见误区​

兼容即代表零差异​

接口兼容仅表示在协议和调用方式层面兼容，并不表示客户端行为、模型命名或平台规则完全一致。

模型名称可以直接照搬​

模型是否可用仍取决于当前分组、令牌权限和实际客户端配置。

接口兼容即代表价格与权限逻辑一致​

价格、分组和权限属于彼源 AI 自身的运营与管理规则，不会因为接口兼容而自动等同于 OpenAI 官方逻辑。

实施建议​

建议按照以下顺序完成迁移：

  1. 替换 Base URL
  2. 替换 API Key
  3. 确认模型名称
  4. 验证 GET /v1/models
  5. 验证最小聊天请求

继续阅读​