カタログ

モデル

GET/v1/models

利用可能なモデル/エンジンを、設定と正確なクレジットコストとともに一覧します。エンジン名の信頼できる出典です。

クエリパラメータ

パラメータ	説明
category任意デフォルト 3d string	一覧する対象: `3d`（テキスト→3D）、`image-to-3d`、`image`、`remesh`、`texture`、`animate`、`parts-board`、`uv-unwrap`。

リクエスト

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 が追加で含まれます。

3D カタログは 2 つあります category=3d はテキスト→3D のエンジンのみを返します。ベンダーが画像入力のみ対応するエンジンはテキスト→3D の項目を持たないため、category=image-to-3d にしか現れません。認識されない値は黙って 3d にフォールバックするので、当て推量の値を渡すとそのエンジンが欠けた「もっともらしい一覧」が返ります。画像→3D が目的なら image-to-3d を明示してください。

アニメーションプリセットカタログ用の GET /v1/animations?engine=tripo|meshy もあります。