텍스트 → 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 | 폴링 대신 완료된 자산을 여러분의 서버로 푸시합니다 — 웹훅을 참고하세요. |
요청
요청
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가 됩니다. 생성 → 폴링 → 다운로드 전체 흐름은 퀵스타트를 참고하세요.