PicoBerry API Reference
A resource-oriented REST API for programmatic 3D and image generation — text-to-image, text/image-to-3D, plus remesh, texture, and auto-rig on any asset you create.
The API accepts JSON (and multipart/form-data for file uploads), returns JSON, uses standard HTTP status codes, and wraps every response in a { success, data } envelope. Generation is asynchronous: a create call returns an asset id; you poll or receive a webhook when it finishes.
Start here
Key to a downloaded 3D model in four copy-paste steps.
Getting startedMint a key and send your first authenticated request.
Getting startedHow create → poll → result works for every job.
GenerateDescribe an asset in words and get a textured mesh.
GenerateTurn one or more images (multi-view) into a textured 3D model.
DeliveryGet pushed a signed callback instead of polling.
Getting startedCosts, rate limits, and refunds on failure.
Endpoint overview
Everything lives under https://api.picoberry.ai/v1. Generation is asynchronous — a create call returns an id you poll or receive by webhook; post-process calls take that same id.
| Endpoint | Purpose |
|---|---|
POST /v1/images | Text → Image |
POST /v1/models/from-text | Text → 3D |
POST /v1/models/from-image | Image, or 2–4 views, → 3D |
POST /v1/images/parts-board | Decompose an image into parts |
POST /v1/assets/{id}/remesh | Retopologize a model |
POST /v1/assets/{id}/texture | Re-texture a model |
POST /v1/assets/{id}/animate | Auto-rig & animate |
POST /v1/assets/{id}/download | Export GLB / FBX / OBJ (sync) |
GET /v1/assets/{id} | Poll status & fetch results |
GET /v1/assets | List your assets |
GET /v1/models | Engine catalog & per-model cost |
GET /v1/credits | Wallet balance & plan |
POST /v1/collections | Organize assets into collections |
Libraries
Use this API from Claude Code, Cursor, Claude Desktop, or Cline. npx -y @picoberry/mcp-server
MCP server source, worked examples, and ready-to-copy client configs.
RESTNo SDK needed — curl, Python, or JavaScript against /v1.
One API, every engine
Pick a generation engine per request — tripo, meshy, hunyuan-3.1, trellis-2 for 3D; nano-banana, gpt-image for images. The catalog and exact per-model cost are authoritative via GET /v1/models.