跳转到主要内容
P1 将图中物体重建为 50 到 20,000 面的低模网格。P1 不支持四边面输出、 超精细几何、智能低模和部件拆分。

端点

异步 —— 返回 {id, status: "pending"};轮询 GET /v1/3d/generations/{id} 直到 success 或 failed。大多数生成 会在 1–3 分钟内完成。幂等性、回调与错误见 3D 生成参考。

参数

string[]
必填
仅含一个元素的数组,为参考图:公开的 HTTPS URL,或 base64 data: URI (提交任务前会先替你托管)。支持 JPEG、PNG、WebP。无法访问的 URL 会在 预留任何费用之前以 400 拒绝。
boolean
默认值:"true"
为模型生成贴图。将它与 pbr 都设为 false 可得到无贴图的白模,计费更低。
boolean
默认值:"true"
生成基于物理的(PBR)材质。pbr: true 会同时开启贴图,因此无贴图白模需要 把 texture 和 pbr 都设为 false。
"fast" | "standard" | "detailed" | "extreme"
默认值:"\"standard\""
detailed 为 HD 贴图,extreme 为 8K 贴图。仅在生成贴图时生效; detailed 与 extreme 会增加费用。 fast 以贴图细节换取速度,按标准价计费;它运行在贴图模型 v3.5-20260815 上,会自动使用。
integer
输出网格的最大面数,范围 50 到 20,000。不传则由模型根据物体自动选择 合适的面数。
boolean
默认值:"false"
按真实世界尺寸缩放模型,单位为米。
boolean
默认值:"false"
让 Tripo 在生成前先优化输入图片,以便从不够理想的照片中获得更好的结果。
"original_image" | "geometry"
默认值:"\"original_image\""
original_image 让贴图忠实于原图;geometry 让贴图对齐生成的网格, 更注重结构准确。
"default" | "align_image"
默认值:"\"default\""
align_image 会旋转模型,使其与图中物体的朝向一致;default 保持标准朝向。
integer
几何随机种子,0 到 2147483647。相同输入配合相同种子可复现同一网格。
integer
贴图随机种子,0 到 2147483647。固定 model_seed 后改变它,可在同一 几何上得到不同贴图。
"v3.5-20260815" | "v3.0-20250812"
独立于几何模型指定贴图模型。不传时使用默认值(v3.0-20250812; texture_quality: "fast" 时为 v3.5-20260815)。
boolean
默认值:"true"
贴图前去除参考图中烘焙的光照。仅贴图模型 v3.5-20260815 读取此项。
boolean
默认值:"true"
生成时展开 UV。设为 false 生成更快、文件更小。
"+x" | "-x" | "-y" | "+y"
默认值:"\"+x\""
导出模型的前向轴。

输出

success 时,data 按固定顺序包含生成的文件:
  • data[0].url —— 3D 模型:内嵌材质的二进制 glTF(.glb)文件。
  • data[1].url —— 模型的 PNG 渲染预览图(Tripo 返回时提供)。
两个文件都托管在 VibeToken 媒体 CDN 上,每个 URL 都以文件的真实扩展名结尾,可据此选择 加载器。需要长期保留的文件请自行下载保存。

示例

轮询直到终态:

选择输入图片

  • 使用单个物体,完整入画,背景为纯色或透明。裁掉其他内容。
  • 清晰的四分之三视角能展示最多的形体;图中看不到的侧面由模型推断。
  • 均匀、没有强烈阴影的光照能得到更干净的贴图。照片不够理想时,可尝试 enable_image_autofix: true。

定价

按次计费;开启的选项会改变价格,失败的生成不收费。影响价格的因素见 Tripo P1 快速入门,当前费率见定价页。