模型

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。