API 快速开始

这页帮你把彼源 AI 接进代码或 SDK（SDK 指各语言封装好的调用工具包）。如果还没有令牌，先看快速开始拿到一个 sk- 开头的密钥。

两条接入信息

项目	值
服务地址（Base URL）	`https://api.biyuan.ai/v1`
鉴权请求头	`Authorization: Bearer <YOUR_TOKEN>`

把 <YOUR_TOKEN> 换成你的令牌（sk- 开头，在控制台令牌管理创建）。

彼源 AI 是 OpenAI 兼容接口。从 OpenAI 迁移时，通常只改三处：Base URL、API Key、模型名（model）。

从 OpenAI SDK 接入

只要把 base_url 指向彼源 AI、把 key 换成你的令牌即可。

Python(openai 库)

from openai import OpenAI

client = OpenAI(
    api_key="<YOUR_TOKEN>",
    base_url="https://api.biyuan.ai/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js(openai 库)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "<YOUR_TOKEN>",
  baseURL: "https://api.biyuan.ai/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.4",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

用 curl 验证

先查一遍可用模型，确认令牌和地址都对：

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": "你好"}]
  }'

返回里有 choices 就说明接通了。模型 ID 从模型广场复制；想确认当前令牌实际可用的模型，调用 GET /v1/models（令牌设置了模型限制时，以这个返回为准）。

建议接入顺序

先跑通 GET /v1/models 和一条非流式聊天请求。
再打开流式输出（stream，回答一边生成一边返回，不用等全部生成完）。
再加工具调用（tools）。
最后扩展图片、视频、音频等能力。

一次只加一样，出错时更容易定位。

遇到问题

401 / 无效的令牌：检查 Authorization: Bearer sk-...，重新复制完整令牌。
404 / Invalid URL：SDK 和标准 OpenAI 客户端的 Base URL 要带 /v1，即 https://api.biyuan.ai/v1；会自行拼接 /v1 的客户端（如 Cherry Studio、NextChat、Claude Code）按各自接入页填不带 /v1 的地址。
该令牌无权访问模型：换一个模型 ID，或到「令牌管理」编辑该令牌放开模型（需开启高级模式）。

完整错误对照见错误与状态码。

继续阅读

OpenAI 兼容说明：Base URL 与完整端点的区别
API 概览：所有可用接口
聊天与文本

两条接入信息​

从 OpenAI SDK 接入​

用 curl 验证​

建议接入顺序​

遇到问题​

继续阅读​