文本 → 3D
POST/v1/models/from-text
用纯文本描述资产，即可获得带纹理的网格。
参数
| 参数 | 说明 |
|---|---|
| prompt必填 string | 要生成的内容。最多 1,024 个字符（Tripo 引擎上限）。 |
| engine可选 string | 要使用的 3D 引擎，例如 tripo、tripo-v3.1、hunyuan-3.1。省略则使用默认引擎。完整列表：GET /v1/models?category=3d。 |
| polycount可选 integer | 目标面数，100–2,000,000。超出范围的值会被限制到该模型的范围（例如 tripo 500–20,000）。各模型的 polygonConfig 请见 GET /v1/models。 |
| texture可选默认 true boolean | 生成 PBR 贴图。设为 false 可获得更快的无纹理网格。 |
| license可选 string | 结果的使用权限。默认为私有（保留所有权利）。 |
| callbackUrl可选 string | 将完成的资产推送到服务器，而不是轮询。详见 Webhook。 |
请求
请求
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 }) });响应
响应 · 200
{ "success": true, "data": { "id": "019…", "taskStatus": 0, "type": "model_3d" } }这是创建响应，任务现已开始运行。轮询 GET /v1/assets/{id}，直到 taskStatus 变为 2，此时 files.model 即为带签名的 GLB。完整的创建 → 轮询 → 下载流程请见快速开始。