Tripo3D

自动绑骨

http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint: POST /animations/rig
自动为 3D 模型添加骨骼绑定。请先运行可绑骨检查以验证兼容性。
注意
  • 此接口需要 API Key 认证。请在 Authorization 请求头中传入 Bearer {api_key}。
  • 此接口为异步 API。提交请求后，请使用 任务查询接口 轮询获取结果，或配置 Webhook 接收任务完成时的自动通知。

请求参数

请求体

inputstring必选
模型来源。接受 task_id 或 file_token。 接受以下输入类型：
以下三种方式任选其一，不可同时传入多种类型。
  • 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、GLTF、FBX、OBJ、STL
  • 最大文件大小：150 MB
modelstring默认值: v1.0-20240301
绑骨模型版本。
  • v1.0-20240301：仅适用于（且推荐用于）双足类人型绑骨。支持 90+ 预设动画。
  • v2.5-20260210：适用于非类人型的动物绑骨（四足、六足、八足、蛇形、水生、鸟类）。
rig_typestring默认值: biped
骨骼类型。建议先调用 rig-check。
  • biped：双足人形。
  • quadruped：四足动物。
  • hexapod：六足生物。
  • octopod：八足生物。
  • avian：鸟类/有翼生物。
  • serpentine：蛇形生物。
  • aquatic：鱼类/水生生物。
specstring默认值: tripo
绑骨规范。
  • tripo：Tripo 原生骨骼命名。
  • mixamo：兼容 Mixamo 的骨骼命名。
out_formatstring默认值: glb
输出格式。
  • glb：二进制 glTF，适用于 Web。
  • fbx：FBX，适用于 DCC 工具和游戏引擎。

示例

自动绑骨
{
  "input": "task_abc123",
  "model": "v2.5-20260210",
  "rig_type": "biped",
  "spec": "mixamo",
  "out_format": "glb"}
创建任务
{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}
任务结果
{
  "code": 0,
  "data": {
    "task_id": "task_def456",
    "status": "success",
    "output": {
      "model_url": "https://cdn.tripo3d.ai/output/rigged.glb"},
    "credits_consumed": 30
  }
}