# 艾波开放平台（AI 工作台）

> 福建布波数字科技自研的 AI 能力平台。对外开放对话、配音、任务查询、调用记录等能力，采用 API Key 鉴权、按调用扣算力。任何 OpenAI 兼容客户端或 Agent 用「Base URL + Key」即可接入，无需登录后台。

- Base URL: https://ai.aibobos.com/api/openapi/v1
- Auth: `Authorization: Bearer aibo_<40hex>`（后台「用户 → API Key」自助签发，明文只显示一次）
- 人看的文档: https://ai.aibobos.com/openapi/
- 机器索引: https://ai.aibobos.com/openapi/index.md
- OpenAPI 3.1: https://ai.aibobos.com/openapi.json
- 快速接入: https://ai.aibobos.com/openapi/agent-quickstart.md
- 站点: https://ai.aibobos.com/
- 更新: 2026-09-26

## Endpoints

- [GET /me](https://ai.aibobos.com/openapi/endpoints/me.md): 归属与用量 — 查这枚 Key 属于谁、开通了哪些能力、累计调用与消耗。Agent 接入后的第一条自检调用。
- [GET /models](https://ai.aibobos.com/openapi/endpoints/models.md): 模型列表 — OpenAI 兼容的模型列表。当前两个：`aibo-chat`（对话）、`aibo-agent`（Agent 编排，同一条链路）。
- [POST /chat/completions](https://ai.aibobos.com/openapi/endpoints/chat-completions.md): 对话（OpenAI 兼容） — 标准 OpenAI Chat Completions。**内置能力编排**：识别到配音/朗读类指令时自动改走配音链路并返回音频地址。
- [GET /voices](https://ai.aibobos.com/openapi/endpoints/voices.md): 可用音色 — 列出当前账号可用的音色（公共音色 + 自己克隆的），并给出默认音色。
- [POST /tts](https://ai.aibobos.com/openapi/endpoints/tts.md): 生成配音 — 文本转语音。**同步优先**：站点语音通道直接出音频就返回 `audio_url`；不可用则转异步任务返回 `id`，用 `/task` 轮询。
- [GET /task?id=<任务ID>](https://ai.aibobos.com/openapi/endpoints/task.md): 查询配音任务 — 按 `id` 查异步配音任务状态。轮询到 `status=2` 即完成，取 `audio_url`。
- [GET /records](https://ai.aibobos.com/openapi/endpoints/records.md): 调用记录 — 当前账号的配音记录列表（倒序），含状态、文案、字数、音频地址与真实时间戳。

## Scopes

- `chat`: 对话 / 模型列表（/models、/chat/completions）
- `tts`: 配音（含查询）（/voices、/tts、/task）
- `records`: 调用记录（/records）
- `draw`: 图像生成（**已预留计费，端点未开放**）（—）

## Billing

- `openapi/chat`: 开放对话调用，1 算力/次
- `openapi/tts`: 开放配音调用，1 算力/次
- `openapi/draw`: 开放图片调用，5（端点未开放） 算力/次

失败自动退回；通道不可用直接 503 且不扣算力（不做假交付）。

## Optional

- [技能包（WorkBuddy 原生）](https://ai.aibobos.com/uploads/skills/aibo-skills.zip): 把本平台能力装进 Agent 的四件套
- [验收入口](https://ai.aibobos.com/workbench/openapicheck.html): 粘 Key 即出 curl