PicoBerry API 参考
面向程序化 3D 与图像生成的资源导向型 REST API。支持文生图、文/图生 3D，还能对生成的任意资产应用重构网格、纹理与自动绑定。
基础 URLhttps://api.picoberry.ai
版本v1
认证Bearer / x-api-key
此 API 接收 JSON（文件上传使用 multipart/form-data），返回 JSON，使用标准 HTTP 状态码，并将每个响应封装在 { success, data } 结构中。生成是异步的：创建请求会返回资产 id；完成后可通过轮询或接收 Webhook 获取结果。
从这里开始
入门
快速开始
复制粘贴四步，从 API 密钥到下载 3D 模型。
入门认证
生成密钥，发送第一个已认证的请求。
入门异步 & 轮询
了解每个任务的“创建 → 轮询 → 结果”流程如何运作。
生成文本 → 3D
用文字描述一个资产，即可获得带纹理的网格。
生成图像 → 3D
将一张或多张（多视图）图像转换为带纹理的 3D 模型。
交付Webhook
无需轮询，直接推送已签名的回调。
入门积分 & 限制
费用、速率限制，以及失败时的退款。
端点概览
所有端点都位于 https://api.picoberry.ai/v1 之下。生成是异步的：创建请求会返回一个可通过轮询或 Webhook 获取的 id，后处理请求使用同一个 id。
| 端点 | 用途 |
|---|---|
POST /v1/images | 文本 → 图像 |
POST /v1/models/from-text | 文本 → 3D |
POST /v1/models/from-image | 单张图像，或 2–4 个视图 → 3D |
POST /v1/assets/{id}/remesh | 对模型重拓扑 |
POST /v1/assets/{id}/texture | 为模型重新贴图 |
POST /v1/assets/{id}/animate | 自动绑定 & 生成动画 |
POST /v1/assets/{id}/download | 导出 GLB / FBX / OBJ （同步） |
GET /v1/assets/{id} | 轮询状态 & 获取结果 |
GET /v1/assets | 列出资产 |
GET /v1/models | 引擎目录 & 各模型费用 |
GET /v1/credits | 钱包余额 & 套餐 |
POST /v1/collections | 将资产整理到合集 |
库
MCP
@picoberry/mcp-server
在 Claude Code、Cursor、Claude Desktop 或 Cline 中直接使用此 API。npx -y @picoberry/mcp-server
GitHub
MCP 服务器源码、实用示例，以及可直接复制的客户端配置。
REST直接调用
无需 SDK，使用 curl、Python 或 JavaScript 直接请求 /v1。
一个 API，覆盖所有引擎
按请求选择生成引擎：3D 可选 tripo、meshy、hunyuan-3.1、trellis-2，图像可选 nano-banana、gpt-image。目录与各模型的准确费用以 GET /v1/models 为准。