跳到主要内容

聊天与文本

彼源 AI 提供两条聊天接口，任选其一即可开始对话：

  • POST /v1/chat/completions — OpenAI 兼容格式，适配绝大多数 SDK、客户端和后端服务。
  • POST /v1/messages — Anthropic Claude Messages 格式，适合原生基于 Claude 结构的工作流。

新接入优先选 chat/completions。只有当你的工具原生使用 Claude Messages（需要 anthropic-version 请求头）时才用 messages。

模型 ID 从模型广场复制，填进下面请求的 model 字段；想确认当前令牌实际可用的模型，调用 GET /v1/models（令牌设置了模型限制时，以这个返回为准）。

Base URL 还是完整地址​

客户端要你填地址时，先看它要哪一种：

客户端要求填该填什么
服务地址（Base URL）https://api.biyuan.ai/v1
完整端点（Full URL）https://api.biyuan.ai/v1/chat/completions

两类输入框不要混填。有两个例外：

  • 用 Anthropic Messages 格式的客户端（如 TRAE 的 Anthropic 模式），服务地址填 https://api.biyuan.ai（不带 /v1），完整端点是 https://api.biyuan.ai/v1/messages。
  • 有些客户端（如 NextChat、Cherry Studio）会自己拼接 /v1，这时服务地址填 https://api.biyuan.ai（不带 /v1）。以对应客户端集成页为准。

发一条聊天请求（Chat Completions）​

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

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": "请用一句话介绍彼源 AI。" }
    ]
  }'

收到一段回复，就说明令牌、地址和模型都通了。

发一条 Claude Messages 请求​

curl https://api.biyuan.ai/v1/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "messages": [
      { "role": "user", "content": "请用三句话总结这段内容。" }
    ]
  }'

用这条接口时，anthropic-version 和 max_tokens 都必须带上。

常用可选能力​

/v1/chat/completions 支持这些字段，按需添加：

  • stream：流式输出
  • tools、tool_choice：函数 / 工具调用
  • response_format：约束返回格式（如 JSON）
  • reasoning_effort：推理模型的思考强度
  • modalities、audio：多模态与语音输出

第一次接入先只发 model + messages，通了再逐项加，排错更快。

排错​

发不出去时，先跑 GET /v1/models 看目标模型在不在返回列表里——看不到多半是当前令牌或分组（Group）没开放这个模型——换一个模型 ID，或新建一个令牌并选择目标分组（见模型分组）。用 /v1/messages 收到 400 时，先检查 messages 数组结构和有没有带 anthropic-version。

继续阅读​