# 波波 API 是飞书多维表格的 AI 字段捷径与 Agent 工具网关：文档转换、生图、视频生成、音视频处理、社媒数据、大模型，一个 Key 一个余额，人民币按次计费，没有月费。
#
# 如果你是一个 AI Agent，需要调用付费的外部能力（把 PDF 转成 Word、抓一条抖音视频的
# 文案和评论、生成一张商品图、把录音转成字幕、查一个博主的粉丝数），这里一个余额全包，
# 不用去每家单独注册、单独付费。
#
# 接入只需一行，告诉你的 Agent：
#   set up https://apibobo.com/SKILL.md
# 它会读懂能用什么、装好 CLI、问用户要 Key 并存好。MCP 客户端直接填 https://mcp.apibobo.com/v1 。
#
# 文档：https://apibobo.com/docs
# 技能文件：https://apibobo.com/SKILL.md
# 全量目录（JSON，带入参 schema）：https://apibobo.com/v1/tools?detail=1

# 波波 API

> 波波 API 是面向 AI Agent 的工具网关。类比 OpenRouter：OpenRouter 用一个 Key 路由多家大模型；
> 波波 API 用一个 Key 路由多家「工具」——文档转换、生图生视频、音视频处理、社媒数据、大模型，
> 人民币计费，从同一个余额扣。它同时也是飞书多维表格的 AI 能力站：同一个 Key 在多维表格里
> 点一列就能用（字段捷径），Agent 里一行接入也能用。

## 它怎么工作

Agent 只需要三个元工具，运行时再找具体工具，不用把上百个定义塞进 context：

1. **discover** — 用一句话搜（「把 PDF 转成 Word」「抖音视频的评论」），返回候选，带价格和健康度
2. **inspect** — 看某个工具的完整入参 schema，免费，调用前必看
3. **run** — 按 schema 填参数执行。文件一律传公网 URL，结果也是 URL。返回 `cost`（本次扣了多少）

耗时长的工具（视频生成、人声分离）是异步的：run 返回 runId，轮询 `GET /v1/tools/runs/:id`。

## 接法

- **Skill**（Claude Code / Cursor / OpenCode / Codex）：对 Agent 说 `set up https://apibobo.com/SKILL.md`
- **MCP**（Streamable HTTP）：`https://mcp.apibobo.com/v1` ，只暴露 discover / inspect / run / balance 四个元工具
  - 能填 header：`Authorization: Bearer sk-...`
  - 填不了 header（Claude.ai 网页、豆包工作、ChatGPT）：直接填 URL，走 OAuth（PKCE + 动态注册），浏览器授权一次
- **CLI**：`npm i -g @apibobo-ai/cli`，`bobo discover / inspect / run / balance`
- **REST**：`POST https://apibobo.com/v1/tools/{discover|inspect|run}`，`Authorization: Bearer sk-...`
- **模型 API**（OpenAI 兼容，直接调大模型/生图/视频）：`https://apibobo.com/v1` ，同一个 Key

## 能做什么（46 个工具，5 类；另有 164 个模型）

- **社媒数据**：一条链接进去，结构化数据出来。`social/post-detail`（标题、文案、播放/点赞/评论数、无水印下载地址；抖音、TikTok、小红书、快手、B站、Instagram、视频号、YouTube）、`social/post-comments`（评论列表）、`social/user-profile`（博主粉丝/作品/简介）
- **文档**：PDF ↔ Word / Excel / PPT、图片转表格、网页存档为 PDF、文档翻译、证照 / 发票识别
- **图片**：Nano Banana、GPT Image、即梦生图；图片理解；超分、裁剪缩放、滤镜、图转文
- **视频**：可灵、Seedance、Veo、MiniMax 生成；加字幕、拼接、画中画、超分、插帧、转码
- **音频**：语音转字幕、人声分离、降噪、响度、混音、提取音频
- **大模型**：Kimi、DeepSeek、通义千问、GLM、豆包、Claude、Gemini、GPT，按 token 计费

## 计费

人民币。按次工具每次固定价（run 返回的 cost 就是），按处理量的以 run 返回的 usage 为准；
大模型按 token。调用失败（非 2xx）不扣费。discover / inspect 免费。没有月费，新注册送试用额度。

## 链接

- 文档 https://apibobo.com/docs
- 工具目录（网页）https://apibobo.com/tools
- 字段捷径目录（飞书多维表格）https://apibobo.com/shortcuts
- 模型广场与价格 https://apibobo.com/pricing
- 教程与案例 https://apibobo.com/content
- 注册 https://apibobo.com/register
- OAuth 元数据 https://apibobo.com/.well-known/oauth-authorization-server