Tripo3D

可绑骨检查

http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint: POST /animations/rig-check
检查模型是否可以绑骨，并返回推荐的骨骼类型。
注意
  • 此接口需要 API Key 认证。请在 Authorization 请求头中传入 Bearer {api_key}。
  • 此接口为异步 API。提交请求后，请使用 任务查询接口 轮询获取结果，或配置 Webhook 接收任务完成时的自动通知。

请求参数

请求体

inputstring必选
模型来源。接受 task_id、file_token 或 URL。 接受以下输入类型：
以下三种方式任选其一，不可同时传入多种类型。
  • task_id：此前 3D 生成任务（text_to_model、image_to_model 或 multiview_to_model）返回的任务 ID。系统会自动使用该任务的 3D 模型输出。
    示例： task_abc123
  • file_token：先通过文件上传 API上传 3D 模型文件，然后传入返回的 token。
    示例： file_abc123
  • URL：可公开访问的 3D 模型文件直链。
    示例： https://example.com/model.glb
说明
  • 支持格式：GLB
  • 最大文件大小：150 MB

返回参数

riggableboolean必选
模型是否可绑骨。
rig_typestring必选
推荐的骨骼类型。
  • biped：双足人形。
  • quadruped：四足动物。
  • hexapod：六足生物。
  • octopod：八足生物。
  • avian：鸟类/有翼生物。
  • serpentine：蛇形生物。
  • aquatic：鱼类/水生生物。

示例

检查示例
{
  "input": "task_abc123"}
创建任务
{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}
任务结果
{
  "code": 0,
  "data": {
    "task_id": "task_def456",
    "status": "success",
    "output": {
      "riggable": true,
      "rig_type": "biped"},
    "credits_consumed": 0
  }
}