快速开始

身份验证

在每个请求中，通过任意一个请求头发送 API 密钥。密钥在仪表板中生成，且仅显示一次。

此 API 面向付费账号开放：需要有效订阅，或至少完成过一次积分包购买。免费账号也可以浏览仪表板，但在没有付款记录之前，/v1 调用会返回 403。

发送密钥

认证请求头
-H "Authorization: Bearer pb_live_xxx"
# or
-H "x-api-key: pb_live_xxx"
headers = {"Authorization": f"Bearer {API_KEY}"}
const headers = { Authorization: `Bearer ${apiKey}` };

轮换密钥

  1. 先创建一个新密钥——不要中断正在运行的集成。
  2. 更新服务以使用新密钥。
  3. 在仪表板中吊销旧密钥。
请将密钥保存在服务端 泄露的 pb_live_ 密钥可能会耗尽全部余额。请将其存放在密钥管理器中，切勿发送到浏览器或提交到代码仓库。

谁可以使用 API

拥有真实付款记录的账号均可使用：需要有效订阅，或至少完成过一次积分包购买。完成的购买将永久授予使用资格，因此当前不必保持订阅状态。若账号没有任何付款记录，调用将返回 403，并附带 error.code 6014。

库 & 工具

无需 SDK——/v1 是采用 { success, data } 封装的纯 REST 接口。如果需要类型化的客户端或智能体集成：

OpenAPI 3
机器可读的规范

在 /api-json 实时提供。可导入 Postman / Insomnia，或据此生成客户端。

 MCP
@picoberry/mcp-server

从 Claude、Cursor 或任意 MCP 智能体驱动 API——npx -y @picoberry/mcp-server。

 REST
直接调用

curl、Python 或 JavaScript——快速开始示例可直接复制粘贴使用。
从实时规范生成类型化客户端
# Any OpenAPI 3 generator works — e.g. openapi-generator
npx @openapitools/openapi-generator-cli generate \
  -i https://api.picoberry.ai/api-json \
  -g typescript-fetch -o ./picoberry-client