カタログ

モデル

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 もあります。