/ API API 文档 获取 API 密钥 →
PicoBerry 生成 API · v1

3D 与图像生成，以及之后的每一步 — 一个 API 全搞定。

用主流引擎生成，再在同一个资产上完成重构网格、重新贴图、绑定与导出 — 全部通过一个异步 REST API。为应用、资产管线和 AI 智能体而打造。

获取 API 密钥 → 查看文档

抢先体验 — 我们分批为开发者开通，通过后会回复并附上密钥。

基础地址 api.picoberry.ai 认证 Bearer pb_live_… 输出 GLB · FBX · PNG
图像 → 3D · curl
# Generate a 3D model from an image
curl -X POST https://api.picoberry.ai/v1/models/from-image \
  -H "Authorization: Bearer pb_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"imageUrl":"https://…/ref.png","engine":"tripo"}'

# → returns an asset id; poll until it's ready
{ "success": true, "data": {
    "id": "019f3a39-0db2-…",
    "taskStatus": 0,
    "type": "model_3d"
} }
在多个主流引擎间路由任务
Tripo Meshy Hunyuan 3D gpt-image nano-banana grok-imagine
为何选择 PicoBerry

不止是单个 3D 模型端点。

无需分别对接五个生成 API。创建、精修与交付一次集成搞定 — 这正是通过 PicoBerry 路由、而非自行调用每个引擎的理由。

一次集成

通过一个密钥、一套 schema 和统一的 { success, data } 响应结构，即可调用 Tripo、Meshy、Hunyuan3D 以及图像模型。改一个字段就能切换引擎。

完整的资产管线

生成后，用 id 对同一个资产进行重构网格、重新贴图和绑定 — 无需重新上传，也无需在不同工具间来回转换格式。

为生产环境打造

异步任务、带签名的 webhook、带签名的下载 URL、可吊销的密钥、速率限制与积分追踪 — 这些原本需要你自己搭建和维护的底层设施。

示例

看看这个 API 能产出什么。

输入一句提示词，产出带纹理的网格 — 角色、生物、场景、道具、武器、载具。每一张图块都是一次 API 调用生成的真实资产。

Wild West Gunsmith Store 文本 → 3Drealistic 3d model of gunsmith store wild west Yellow Scuba Tank Starfish 文本 → 3DYellow Scuba Tank Starfish Wolf Monk With Staff (Remeshed) 文本 → 3DWolf Monk With Staff (Remeshed) Anime Girl In Sci-Fi Suit 文本 → 3DAnime Girl In Sci-Fi Suit Banana Palm Tree 文本 → 3DBanana Palm Tree Cartoon Lion Safari Guide (Animated: Standing Relax) 文本 → 3DCartoon Lion Safari Guide (Animated: Standing Relax) Ashurath Desert Wanderer Character 文本 → 3DAAA game-ready playable male character for ORITHAL, a 3D isometric Ancient Fanta Stylized Green Bushy Tree 文本 → 3DStylized Green Bushy Tree model 文本 → 3Dvalheim style viking boat Brazilian Soccer Player Bobblehead 文本 → 3DBrazilian Soccer Player Bobblehead Armored Magma Golem Monster 文本 → 3DA massive, game-ready 3D monster model of an armored magma golem, with volcanic Gothic Stone Pedestal with Gems 文本 → 3DGothic Stone Pedestal with Gems Stylized Purple Flower 文本 → 3DStylized Purple Flower Pirate Village Building 文本 → 3Dcreate a pirate village building Sci-Fi Round Device 文本 → 3DSci-Fi Round Device Whimsical Medieval Anime House 文本 → 3DA charming, whimsical two-story medieval-style house with exaggerated, inviting Anime Stylized Palm Tree 文本 → 3DA tall, slender anime-style palm tree stands gracefully, its trunk a smooth, war Anime Girl With Horns 文本 → 3DAnime Girl With Horns Anime Boy Adventurer Character 文本 → 3DAnime Boy Adventurer Character Low Poly Automatic Gun 文本 → 3DA low poly automatic gun for the use in my low poly fps game Stylized Low Poly Pistol 文本 → 3Dlow poly semi automatic pistol, hard surface, clean edges, stylized FPS game wea Cute Mermaid Hair Styles 文本 → 3DCute Mermaid Hair Styles Cartoon Taco Filled With Beans 文本 → 3DCartoon Taco Filled With Beans Chibi Elf Girl T-Pose 文本 → 3DChibi Elf Girl T-Pose Chibi Anime Girl Knight (Remeshed) 文本 → 3DChibi Anime Girl Knight (Remeshed) Chibi Nun Character 文本 → 3DChibi Nun Character Chibi Cyberpunk Girl Character 文本 → 3DChibi Cyberpunk Girl Character Underwater Mermaid Treasure Hunt 文本 → 3DUnderwater Mermaid Treasure Hunt Spacecraft Air Carrier 文本 → 3Dspacecraft air carrier Frost King Character Model 文本 → 3DStylized 3D mobile game Frost King character, under 7000 triangles, clean topolo
POST/v1/models/from-text每张图块背后的调用
curl -X POST https://api.picoberry.ai/v1/models/from-text   -H "Authorization: Bearer pb_live_…"   -d '{"prompt":"armored magma golem, glowing cracks, low-poly","engine":"hunyuan-3.1"}'
快速开始

四步搞定，从零到下载好资产。

1

获取密钥

申请访问权限，然后在仪表盘中生成密钥，并作为 Authorization: Bearer 发送。

2

提交任务

POST /v1/models/from-image — 或 from-text、images。返回一个资产 id。

3

轮询或 webhook

轮询 GET /v1/assets/{id} 直到 taskStatus: 2，或接收带签名的回调。

4

下载

拉取带签名的 GLB/FBX URL — 或先用重构网格、贴图和绑定进一步精修。

完整流程见文档 — 认证、异步与轮询、webhook。

功能

资产管线的每一步，都是一个端点。

生成后在同一个资产上直接精修 — 无需离开 API 即可完成重构网格、重新贴图和绑定。

POST/v1/images

文本 → 图像

支持参考图引导（最多 4 张）的提示词生成图像。产出可直接送入图像 → 3D。

POST/v1/models/from-text

文本 → 3D

用纯文本描述资产。选择引擎和面数预算；默认附带 PBR 贴图。

POST/v1/models/from-image

图像 → 3D

将任意图像 — 包括你自己生成的图像 — 转换为带纹理的网格。

POST/v1/assets/{id}/remesh

重构网格

按目标三角形或四边形数量重新拓扑。保持外观，降低面数。

POST/v1/assets/{id}/texture

重新贴图

根据提示词或参考图，就地重绘 PBR 材质。

POST/v1/assets/{id}/animate

自动绑定与动画

自动为人形绑定骨骼，并重定向行走、奔跑或待机片段 — 无需手动刷权重。

POST/v1/assets/{id}/download

导出

GLB、FBX 或 OBJ — 附带 Unity 纹理预设，包含通道分离贴图和一个 .meta。

GET/v1/assets

资产与合集

列出、获取并整理你生成的一切。带签名的 URL，随时可下载。

引擎支持

为每个请求选择合适的引擎。

每个任务只需设置一个 engine 字段。每种引擎各有所长 — 先用默认值开始，当需要特定风格或预算时再切换。

引擎类型适用场景输入输出典型耗时
Tripo3D快速可靠的文本、图像 → 3Dtext · imageGLB · FBX~60–90s
Meshy3D风格化 3D 资产text · imageGLB · FBX~2 min
Hunyuan3D3D高细节、锐利的几何体text · imageGLB · FBX~2–3 min
gpt-image图像精准的提示词与参考图编辑text · imagePNG~20–40s
nano-banana图像快速的图像生成与编辑text · imagePNG~10–20s
grok-imagine图像xAI Imagine — 风格化生成与编辑text · imagePNG~15–30s

典型耗时针对标准任务，复杂资产会更久。权威目录和每个模型的积分成本始终可在 GET /v1/models 实时查看。

6+
引擎
一个 API 背后集成 3D 与图像模型。
~90s
典型 3D 任务
标准文本/图像转 3D；复杂资产会更久。
240
请求 / 分钟
每 IP 默认上限；每用户 120 次生成/分钟。可按需上调。
GLB
+ FBX / OBJ
通过带签名的 URL 提供 PBR 贴图和 Unity 就绪预设。
适用于

从一句提示词到可交付的资产。

游戏开发

几分钟填满一个场景

用一句提示词批量生成道具变体，将每个重构网格到约 5k 三角面预算，再导出 Unity 就绪的 GLB — 一条管线，一个资产 id。

XR 与空间计算

按需生成资产

为 AR 试穿和世界构建生成轻量、带纹理的低模网格，通过应用在运行时获取的带签名 URL 交付。

电商

商品转 3D

将一张商品照片变成面向网页浏览者的可交互 3D 预览 — 图像转 3D、按网页预算重构网格，再导出 GLB。

智能体与工具

为你的 LLM 提供的 3D 工具

将 PicoBerry 作为 MCP 工具暴露，让智能体自主创建、精修和下载资产 — 输入文本或图像，输出 GLB。

常见问题

在你集成之前。

如何获取访问权限并进行认证？+
该 API 目前处于抢先体验阶段。申请访问权限后，我们会为你的账号开通密钥生成；然后在仪表盘中生成密钥 — 仅显示一次 — 并作为 Authorization: Bearer pb_live_…（或 x-api-key）发送。
生成是同步的吗？+
不是 — 它是异步的。创建调用会返回一个带 taskStatus: 0 的资产 id。轮询 GET /v1/assets/{id} 直到 taskStatus 为 2（成功），或注册一个 webhook 以推送方式接收结果。
计费是如何运作的？+
生成会从你的统一钱包中扣除积分 — 一个 3D 模型约 60–80 积分，一张图像约 15–50 积分。积分在任务开始时扣除，失败则自动退还。实时余额见 GET /v1/credits。
速率限制是多少？+
每 IP 240 次请求/分钟，每用户 120 次生成请求/分钟。超出限制会返回 429 及 error.code: 10003 — 请退避后重试。
我可以导出哪些格式？+
GLB（单文件），或与纹理一起打包为 .zip 的 FBX / OBJ。Unity 预设会分离通道并附带一个 .meta。
我可以接收 webhook 吗？+
可以。在任意任务上传入 callbackUrl 和 webhookSecret；完成时 PicoBerry 会 POST 一个带签名的 asset.succeeded / asset.failed 事件。请校验 X-PB-Signature HMAC，并按 X-PB-Delivery-Id 去重。
我可以选择引擎吗？+
可以 — 为每个任务设置 engine 字段（3D 用 tripo、meshy、hunyuan-3.1；图像用 nano-banana、gpt-image、grok-imagine），或留空以使用该任务类型的默认引擎。实时目录和每个模型的成本见 GET /v1/models。
任务失败会怎样？+
积分在任务开始时扣除，失败则自动退还 — 你只需为成功的生成付费。失败会带有类型化的 error.code；参见错误处理。
可以用于生产环境吗？+
可以 — 这个 API 就是为生产环境打造的：异步任务、带签名的 webhook、带签名的下载 URL 以及速率限制。需要更高的限额或批量定价？联系我们。
如何测试我的集成？+
用低成本模型对实时 API 进行验证 — 失败的任务不计费，你可以随时用 GET /v1/credits 查看余额。
你们提供 SDK 或 OpenAPI 规范吗？+
完整的 REST 参考见文档，OpenAPI 3 规范可在 GET /api-json 获取 — 可导入 Postman 或生成类型化客户端。目前尚未发布特定语言的 SDK；在此之前，该规范可为大多数语言生成客户端。
资产归谁所有？可以商用吗？+
你生成的资产的所有权和商用条款载于我们的服务条款。有特定的使用场景？联系我们。
你们会存储我上传的文件吗？资产会保留多久？+
上传的文件和生成的资产如何存储与保留，详见我们的隐私政策。你可以在仪表盘中管理自己拥有的资产。

获取你的 API 密钥。

登录你的 PicoBerry 仪表盘并生成密钥 — 仅显示一次。

获取 API 密钥 → 查看文档

想先了解一下？浏览文档和模型目录。