Generate

Text → 3D

POST/v1/models/from-text

Describe an asset in plain text and get a textured, game-ready mesh.

Parameters

Parameter	Description
promptREQ string	The generation prompt. Up to 1,024 characters.
engine string	`tripo`, `tripo-v3.1`, `hunyuan-3.1`. See `GET /v1/models?category=3d`.
polycount integer	100–2,000,000, clamped per model.
texture boolean	Generate PBR textures. Default `true`.

Request

request

curl -X POST https://api.picoberry.ai/v1/models/from-text \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"prompt":"a stylized treasure chest","engine":"tripo","polycount":10000}'

requests.post("https://api.picoberry.ai/v1/models/from-text", headers=headers,
    json={"prompt": "a stylized treasure chest", "engine": "tripo", "polycount": 10000})

await fetch(`${BASE}/v1/models/from-text`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "a stylized treasure chest", engine: "tripo", polycount: 10000 }) });

Response

response · 200

{ "success": true, "data": { "id": "019…", "taskStatus": 0, "type": "model_3d" } }