생성

텍스트 → 3D

POST/v1/models/from-text

자산을 일반 텍스트로 설명하면 텍스처가 입혀진, 게임에 바로 쓸 수 있는 메시를 받습니다.

파라미터

파라미터설명
promptREQ
string		생성 프롬프트. 최대 1,024자.
engine
string		tripo, tripo-v3.1, hunyuan-3.1. GET /v1/models?category=3d를 참고하세요.
polycount
integer		100–2,000,000, 모델별로 범위가 제한됩니다.
texture
boolean		PBR 텍스처를 생성합니다. 기본값 true.

요청

요청
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" } }