帮你快速理解、总结文档立即下载
文档中心>大模型服务平台 TokenHub>调用指南>3D 生成模型>Tripo 调用指南

Tripo 调用指南

最近更新时间：2026-08-19 15:55:00
我的收藏

本页目录：

概述

Tripo 3D 生成模型能够通过文本或图片快速生成高质量3D 模型，应用于游戏开发、电商展示、影视预演和 3D 打印等场景，大幅降低 3D 内容的生产门槛与成本。

立即使用

大模型服务平台 TokenHub 采用标准 OpenAI Chat Completions API 协议，您可以直接使用 OpenAI SDK 或任何兼容客户端接入。您可以调用 API 对 Tripo3D 模型进行操作，具体使用方式详见对应接口文档。
模型
Model name
接口功能
Tripo-3D-3.1
可实现高保真 3D 生成，支持最高 200 万面数（2M polygons）。
Tripo-3D-P1
即使在面数较低的情况下，它依然能提供极其精细且精准的几何体。

图片输入要求

文本小于1024字符，图像分辨率大于 256 × 256 像素；支持 JPEG、PNG 格式，最大 20MB。
输入图片建议：
1. 背景简洁（纯色背景）；
2. 不含文字或渐变色；
3. 仅包含单一主体；
4. 主体在画面中占比超过 50%。

OpenAI 兼容接口调用示例

Tripo 3D 兼容了 OpenAI 的接口规范，这意味着您可以在 OpenAI 协议中使用 cURL 来调用 Tripo 3D 模型。您仅需要将 YOUR_API_KEY 替换成 Tripo 的相关配置，即可将您的应用切换到 Tripo 3D。

Tripo-3D-3.1

base_url：https://tokenhub.tencentmaas.com/v1/api/3d/submit。
以下以 Tripo-3D-3.1模型为例的请求示例代码：
cURL

curl -X POST 'https://tokenhub.tencentmaas.com/v1/api/3d/submit' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
    "model": "tripo-3d-3.1",
    "prompt": "一只可爱的小猫"
  }'
输出代码如下，请记录响应 id ，作为查询 Tripo 生3D 任务的输入参数：
cURL

{
  "id": "14721*****320",
  "request_id": "11f64379-bb0b-46b2-b89f-17d75fc12365",
  "object": "3d_job",
  "created_at": 1784885898,
  "status": "queued"
}

查询 Tripo 生3D 任务

base_url：https://tokenhub.tencentmaas.com/v1/api/3d/query。
以下以 Tripo-3D-3.1模型为例的请求示例代码：
cURL

curl -X POST 'https://tokenhub.tencentmaas.com/v1/api/3d/query' \\
  -H 'Authorization: Bearer YOUR_API_KEY' \\
  -H 'Content-Type: application/json' \\
  -d '{
    "model": "tripo-3d-3.1",
    "id": "14721*****320"
  }'
输出示例：
cURL

{
  "status": "success",
  "input": {
    "prompt": "一只可爱的小猫",
    "pbr": true,
    "texture": true,
    "export_uv": true,
    "geometry_quality": "standard",
    "texture_alignment": "geometry",
    "model_version": "v3.1-20260211"
  },
  "output": {
    "type": "text_to_model",
    "model_url": "https://vcg-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/**********12.glb",
    "generated_image_url": "https://vcg-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/**********12.png",
    "rendered_image_url": "https://vcg-prod-1258344699.cos.ap-guangzhou.tencentcos.cn/**********12.png"
  },
  "created_at": 1785989483,
  "completed_at": 1785989483
}

中国站