/ API API Docs Get your API key →
PicoBerry Generation API · v1

One API for 3D & image generation — and everything after.

Generate with leading engines, then remesh, retexture, rig, and export — all on the same asset, through one async REST API. Built for apps, asset pipelines, and AI agents.

Get your API key → Read the docs

Early access — we onboard developers in batches and reply with a key.

Base api.picoberry.ai Auth Bearer pb_live_… Out GLB · FBX · PNG
image → 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"
} }
Route jobs across leading engines
Tripo Meshy Hunyuan 3D gpt-image nano-banana grok-imagine
Why PicoBerry

More than a single 3D model endpoint.

Skip wiring up five separate generation APIs. Get one integration for creation, refinement, and delivery — the reason to route through PicoBerry instead of calling each engine yourself.

One integration

Reach Tripo, Meshy, Hunyuan3D, and image models through a single key, schema, and { success, data } envelope. Change engines with one field.

Full asset pipeline

Generate, then remesh, retexture, and rig the same asset by id — no re-uploads and no format juggling between separate tools.

Built for production

Async jobs, signed webhooks, signed download URLs, revocable keys, rate limits, and credit tracking — the plumbing you'd otherwise build and maintain yourself.

Examples

See what the API produces.

One prompt in, a game-ready mesh out — characters, creatures, environments, props, weapons, vehicles. Every tile is a real asset from a single API call.

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

Zero to a downloaded asset in four steps.

1

Get a key

Request access, then mint a key in the dashboard and send it as Authorization: Bearer.

2

Submit a job

POST /v1/models/from-image — or from-text, images. Returns an asset id.

3

Poll or webhook

Watch GET /v1/assets/{id} until taskStatus: 2, or receive a signed callback.

4

Download

Pull a signed GLB/FBX URL — or refine with remesh, texture, and rig first.

Full walkthrough in the docs — authentication, async & polling, webhooks.

Capabilities

Every step of the asset pipeline, as an endpoint.

Generate, then refine on the same asset — remesh, retexture, and rig without leaving the API.

POST/v1/images

Text → Image

Prompt-to-image with reference guidance (up to 4). Feed the result straight into image-to-3D.

POST/v1/models/from-text

Text → 3D

Describe an asset in plain text. Pick an engine and polygon budget; PBR textures by default.

POST/v1/models/from-image

Image → 3D

Turn any image — including your own generations — into a textured, game-ready mesh.

POST/v1/assets/{id}/remesh

Remesh

Retopologize to a target triangle or quad count. Keep the look, drop the polycount.

POST/v1/assets/{id}/texture

Re-texture

Repaint PBR materials from a prompt or a reference image, in place.

POST/v1/assets/{id}/animate

Auto-rig & Animate

Rig humanoids automatically and retarget a walk, run, or idle clip — no manual weights.

POST/v1/assets/{id}/download

Export

GLB, FBX, or OBJ — with a Unity texture preset that ships channel-split maps and a .meta.

GET/v1/assets

Assets & Collections

List, fetch, and organize everything you generate. Signed URLs, ready to download.

Engine support

Pick the right engine per request.

Set one engine field per job. Each has different strengths — start with a default and switch when a specific look or budget calls for it.

EngineTypeBest forInputOutputTypical
Tripo3DFast, reliable text & image → 3Dtext · imageGLB · FBX~60–90s
Meshy3DStylized, game-ready assetstext · imageGLB · FBX~2 min
Hunyuan3D3DHigh-detail, sharp geometrytext · imageGLB · FBX~2–3 min
gpt-imageImagePrecise prompts & reference editstext · imagePNG~20–40s
nano-bananaImageFast image generation & editstext · imagePNG~10–20s
grok-imagineImagexAI Imagine — stylized generation & editstext · imagePNG~15–30s

Typical times are for standard jobs; complex assets take longer. The authoritative catalog and per-model credit cost are always live at GET /v1/models.

6+
Engines
3D and image models behind one API.
~90s
Typical 3D job
Standard text/image-to-3D; complex assets take longer.
240
Req / min
Default per-IP limit; 120 generations/min per user. Higher on request.
GLB
+ FBX / OBJ
PBR textures and a Unity-ready preset, via signed URL.
Built for

From a prompt to a shippable asset.

Game development

Fill a scene in minutes

Generate a batch of prop variations from one prompt, remesh each to a ~5k-tri budget, and export Unity-ready GLB — one pipeline, one asset id.

XR & spatial

Assets on demand

Produce lightweight, textured, low-poly meshes for AR try-on and world-building, delivered by signed URL your app fetches at runtime.

E-commerce

Product to 3D

Turn one product photo into an interactive 3D preview for web viewers — image-to-3D, remesh to web budget, then export GLB.

Agents & tools

A 3D tool for your LLM

Expose PicoBerry as an MCP tool so an agent can create, refine, and download assets on its own — text or image in, GLB out.

Questions

Before you integrate.

How do I get access & authenticate?+
The API is in early access. Request access and we enable key minting on your account; then mint a key in the dashboard — it's shown once — and send it as Authorization: Bearer pb_live_… (or x-api-key).
Is generation synchronous?+
No — it's async. A create call returns an asset id with taskStatus: 0. Poll GET /v1/assets/{id} until taskStatus is 2 (succeeded), or register a webhook to be pushed the result.
How does billing work?+
Generation spends credits from your unified wallet — a 3D model ≈ 60–80 credits, an image ≈ 15–50. Credits are deducted when a job starts and automatically refunded if it fails. Live balance is at GET /v1/credits.
What are the rate limits?+
240 requests/min per IP and 120 generation requests/min per user. Over the limit returns 429 with error.code: 10003 — back off and retry.
What formats can I export?+
GLB (single file), or FBX / OBJ bundled as a .zip with textures. A Unity preset splits channels and ships a .meta.
Can I receive webhooks?+
Yes. Pass a callbackUrl and webhookSecret on any job; PicoBerry POSTs a signed asset.succeeded / asset.failed event when it finishes. Verify the X-PB-Signature HMAC and dedupe on X-PB-Delivery-Id.
Can I choose the engine?+
Yes — set the engine field per job (tripo, meshy, hunyuan-3.1 for 3D; nano-banana, gpt-image, grok-imagine for images), or leave it out to use the default for that job type. The live catalog and per-model cost are at GET /v1/models.
What happens when a job fails?+
Credits are deducted when a job starts and automatically refunded if it fails — you're billed only for successful generations. Failures carry a typed error.code; see error handling.
Can I use this in production?+
Yes — the API is built for production: async jobs, signed webhooks, signed download URLs, and rate limits. Need higher limits or volume pricing? Talk to us.
How do I test my integration?+
Validate against the live API with a low-cost model — failed jobs aren't charged, and you can check your balance any time with GET /v1/credits.
Do you provide SDKs or an OpenAPI spec?+
The full REST reference is in the docs, and an OpenAPI 3 spec is served at GET /api-json — import it into Postman or generate a typed client. Language-specific SDKs aren't published yet; the spec generates a client in most languages in the meantime.
Who owns the assets? Can I use them commercially?+
Ownership of the assets you generate and commercial-use terms are set out in our Terms of Service. Have a specific use case? Reach out.
Do you store my uploads? How long are assets kept?+
How uploads and generated assets are stored and retained is covered in our Privacy Policy. You can manage the assets you own from the dashboard.

Get your API key.

Sign in to your PicoBerry dashboard and mint a key — it's shown once.

Get your API key → Read the docs

Prefer to explore first? Browse the docs and model catalog.