Base URL https://ai.aibobos.com/api/openapi/v1 · 更新于 2026-09-26 ·
福建布波数字科技 · AI 工作台
| 方法 | 路径 | 能力域 | 说明 | 文档 |
|---|---|---|---|---|
| GET | /me |
— | 归属与用量 查这枚 Key 属于谁、开通了哪些能力、累计调用与消耗。Agent 接入后的第一条自检调用。 |
.md |
| GET | /models |
chat | 模型列表 OpenAI 兼容的模型列表。当前两个：`aibo-chat`（对话）、`aibo-agent`（Agent 编排，同一条链路）。 |
.md |
| POST | /chat/completions |
chat | 对话（OpenAI 兼容） 标准 OpenAI Chat Completions。**内置能力编排**：识别到配音/朗读类指令时自动改走配音链路并返回音频地址。 |
.md |
| GET | /voices |
tts | 可用音色 列出当前账号可用的音色（公共音色 + 自己克隆的），并给出默认音色。 |
.md |
| POST | /tts |
tts | 生成配音 文本转语音。**同步优先**：站点语音通道直接出音频就返回 `audio_url`；不可用则转异步任务返回 `id`，用 `/task` 轮询。 |
.md |
| GET | /task?id=<任务ID> |
tts | 查询配音任务 按 `id` 查异步配音任务状态。轮询到 `status=2` 即完成，取 `audio_url`。 |
.md |
| GET | /records |
records | 调用记录 当前账号的配音记录列表（倒序），含状态、文案、字数、音频地址与真实时间戳。 |
.md |
Authorization: Bearer aibo_<40位十六进制>
在 工作台 → API Key 自助签发， 明文只显示一次；服务端只存 sha256，无法找回，丢了就吊销重签。
| scope | 覆盖 | 端点 |
|---|---|---|
chat | 对话 / 模型列表 | /models、/chat/completions |
tts | 配音（含查询） | /voices、/tts、/task |
records | 调用记录 | /records |
draw | 图像生成（**已预留计费，端点未开放**） | — |
| module / cost_type | 名称 | 算力 / 次 |
|---|---|---|
openapi/chat | 开放对话调用 | 1 |
openapi/tts | 开放配音调用 | 1 |
openapi/draw | 开放图片调用 | 5（端点未开放） |
503 且不扣——宁可不接，不做假交付。402 是扣费失败，此时没有交付物，也不会留下扣费记录。
| HTTP | message | 含义 |
|---|---|---|
401 | 缺少 Authorization: Bearer <API Key> | 没带 Key 或格式不对。 |
401 | API Key 无效或已被删除 | Key 不存在，或已在后台删除。 |
401 | API Key 已被吊销 | Key `status=0`，不可恢复，请重新签发。 |
401 | API Key 已过期 | 超过 `expires_at`。 |
401 | 该 Key 未开通此能力（scope: xxx） | 能力域不含该端点所需 scope。 |
400 | text 不能为空 / messages 不能为空 | 参数缺失。 |
400 | 文案超出长度限制 | 超过 `tts_max_chars`。 |
402 | 算力不足：… | 扣费失败（余额/免费额度/黑名单）。**未产生交付，不计费**。 |
404 | 任务不存在 | 任务 ID 不存在或不属于当前账号。 |
500 | 生成失败：… | 上游模型异常。**已自动退回本次算力**。 |
503 | 配音通道未就绪：… | 语音通道全不可用。**本次不扣算力**，可直接重试。 |
/task——2–3 秒一次足够。stream=true 当前按非流式返回。