彼源 AI 提供一套以 OpenAI 兼容为主的中转 API，覆盖聊天、补全、Responses、Claude Messages、嵌入、图片、音频、实时、视频、Rerank 和审核等能力。这页按能力列出主要路径，方便你快速找到要调用的接口。
基础地址
接口都以这个服务地址（Base URL）为前缀：
例如聊天接口的完整地址是 https://api.biyuan.ai/v1/chat/completions。鉴权方式统一见鉴权方式。
文本与对话
| 能力 | 方法与路径 | 说明 |
|---|
| 聊天补全 | POST /chat/completions | 最常用，多数客户端和 OpenAI SDK 的默认接口 |
| 文本补全 | POST /completions | 旧版 Completions 风格 |
| Responses | POST /responses | 新版 OpenAI Responses 风格，支持工具调用与推理流程 |
| Responses 压缩 | POST /responses/compact | 压缩长对话上下文 |
| Claude Messages | POST /messages | Anthropic Messages 协议，需带 anthropic-version |
向量与检索
| 能力 | 方法与路径 | 说明 |
|---|
| 嵌入向量 | POST /embeddings | 把文本转成向量，用于检索、聚类、相似度 |
| 重排序 | POST /rerank | 对候选结果按相关性重新排序 |
| 能力 | 方法与路径 | 说明 |
|---|
| 文生图 | POST /images/generations | 按提示词生成图片 |
| 图片编辑 | POST /images/edits | 基于已有图片修改 |
| 异步文生图 | POST /images/generations/async | JSON 请求，提交成功返回 202 |
| 异步图片编辑 | POST /images/edits/async | 必须用 multipart/form-data，提交成功返回 202 |
| 查询图片任务 | GET /images/tasks/{task_id} | 统一轮询异步生成和编辑任务，只能查询自己的任务 |
音频与实时
| 能力 | 方法与路径 | 说明 |
|---|
| 语音转文字 | POST /audio/transcriptions | 转写音频 |
| 语音翻译 | POST /audio/translations | 转写并翻译为英文 |
| 文字转语音 | POST /audio/speech | 合成语音 |
| 实时（Realtime） | wss://api.biyuan.ai/v1/realtime | WebSocket 实时语音 / 对话；这是 WebSocket 连接，不是普通 HTTP 接口，详见音频与 Realtime |
| 能力 | 方法与路径 | 说明 |
|---|
| 视频生成 | POST /video/generations | 提交视频生成任务 |
| 查询视频任务 | GET /video/generations/{task_id} | 轮询任务状态 |
| OpenAI 兼容视频 | POST /videos、GET /videos/{task_id} | OpenAI 风格的提交与查询 |
| OpenAI 兼容取结果 | GET /videos/{task_id}/content | 任务完成后下载视频文件 |
视频接口都是异步的：先提交任务拿到 task_id，再轮询查询结果。完整流程见视频生成。
| 能力 | 方法与路径 | 说明 |
|---|
| 内容审核 | POST /moderations | 检测文本是否违规 |
模型与账户
| 能力 | 方法与路径 | 说明 |
|---|
| 模型列表 | GET /models | 查看当前令牌可见的模型 |
| 模型详情 | GET /models/{model} | 查询单个模型信息 |
| 账户余额 | GET /balance | 查询令牌额度、钱包余额及订阅快照 |
余额也可以到控制台「钱包管理」查看，每条请求的消耗在「使用日志」查看。
首次接入或排查「模型不可用」时，先调 GET /models——它能一步验证 Base URL、令牌和可见模型。
继续阅读