跳转到主要内容
P1 生成 50 到 20,000 面的低模网格。P1 不支持四边面输出、超精细几何、 智能低模和部件拆分。

端点

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

参数

string
必填
描述要生成的物体的文本。最长 1024 字符。
string
不希望出现在模型中的内容。最长 255 字符。
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"
按真实世界尺寸缩放模型,单位为米。
integer
几何随机种子,0 到 2147483647。相同输入配合相同种子可复现同一网格。
integer
贴图随机种子,0 到 2147483647。固定 model_seed 后改变它,可在同一 几何上得到不同贴图。
integer
提示词处理阶段的随机种子,0 到 2147483647。与 model_seed、 texture_seed 一起固定,可复现文生 3D 的结果。
"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 都以文件的真实扩展名结尾,可据此选择 加载器。需要长期保留的文件请自行下载保存。

示例

轮询直到终态:

编写提示词

  • 描述单个物体而不是场景:形状、材质、颜色和风格,例如「一把竹柄陶瓷茶壶,哑光蓝釉」。
  • 不想要的内容(底座、文字、多余部件)写进 negative_prompt,而不是写进提示词。
  • 迭代时固定 model_seed、改变 texture_seed(或反过来),让几何与贴图分别变化。

定价

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