카탈로그

모델

GET/v1/models

사용 가능한 모델/엔진을 설정 및 정확한 크레딧 비용과 함께 조회합니다 — 엔진 이름의 신뢰할 수 있는 출처입니다.

쿼리 파라미터

파라미터설명
category선택기본 3d
string		조회할 카테고리: 3d, image, remesh, texture, animate.

요청

요청
curl "https://api.picoberry.ai/v1/models?category=3d" \
  -H "Authorization: Bearer pb_live_xxx"
requests.get("https://api.picoberry.ai/v1/models", headers=headers, params={"category": "3d"})
await fetch(`${BASE}/v1/models?category=3d`, { headers });

응답

모델 배열입니다 — 각 항목은 name(engine / model 값으로 사용), 표시용 label, description, 그리고 정확한 크레딧 cost를 담고 있습니다. 문서에 복사된 어떤 목록보다 이 엔드포인트를 진실의 출처로 삼으세요.

응답 · 200
{ "success": true, "data": [
  {
    "name": "tripo",
    "label": "PB Slim",
    "description": "Fast low-poly mesh for game engines",
    "cost": 60,
    "textureCost": 20,
    "duration": 90000,
    "paidOnly": false,
    "polygonConfig": { "default": 5000, "min": 500, "max": 20000 }
  }
] }
category 기본값은 3d GET /v1/models를 파라미터 없이 호출하면 3D 엔진만 반환되며, 인식되지 않는 값은 오류 대신 3d로 대체됩니다 — 항상 의도한 category를 명시하세요. 이미지 모델에는 supportedAspectRatios가 추가로 포함됩니다.

애니메이션 프리셋 카탈로그를 위한 GET /v1/animations?engine=tripo|meshy도 있습니다.