贴图模型（v3.0-20250812）
本页列出 texture_model 在 model_version 为 v3.0-20250812 时支持的全部参数。
接口地址
参数
必填参数
type: 该字段必须设置为 texture_model。
original_model_task_id: 上一个模型任务的 task_id。上游任务的 model_version 需为 Turbo-v1.0-20250506 或 v2.0-20240919 及以上。仅支持使用具有 model 输出 的任务 ID。
注意
text_to_model、image_to_model 和 multiview_to_model 的 1.x 版本任务不支持作为上游任务。
texture_prompt: 结构如下：
text: 用于引导贴图生成的text值，与image、images互斥。image: 用于引导贴图生成的file对象，与text、images互斥。images: 用于引导贴图生成的file列表，与text、image互斥。style_image(Optional):file对象，可提供风格参考图来影响生成模型的艺术风格。
File object
file: 指定图像输入。
type: 表示文件类型。虽然当前不会严格校验，但强烈建议填写正确的文件类型。file_token: 从上传接口获得的标识，请参考直接上传部分。与url和object互斥。url: 图像的直链 URL。支持 JPEG 和 PNG，最大 20MB。与file_token和object互斥。object（强烈推荐）: 从上传接口获取的对象信息，请参考 Upload in STS。与url和file_token互斥。bucket: 通常固定为tripo-data。key: 返回值中的resource_uri。
可选参数
model_version: 应设置为 v3.0-20250812。
texture: bool 值，用于启用贴图。默认值为 true。当 pbr=true 时，设为 false 仅更新 pbr 贴图。
pbr: bool 值，用于启用 pbr。默认值为 true。设为 false 可输出不带 pbr 的模型。
texture_seed: 一个 integer 值；若不设置将随机生成。它是 model_version>=v2.0-20240919 或 Turbo-v1.0-20250506 时纹理生成的随机种子。使用相同种子会得到一致的贴图。若希望同一模型生成不同贴图，请保持 model_seed 相同并使用不同的 texture_seed。
texture_alignment: 用于控制 3D 模型贴图对齐策略优先级的 text 值。默认值为 original_image。可选值如下：
original_image: 优先贴近源图视觉效果。该选项会让贴图更像原图，但可能产生轻微的 3D 一致性偏差。geometry: 优先保证 3D 结构准确性。该选项会更贴合模型几何结构，但外观可能与原图略有差异。
texture_quality: 用于控制贴图质量的 text 值。可选 detailed 或 standard。detailed 会提供更高分辨率贴图，在复杂细节上更精细、更真实，适合对视觉保真度要求较高的模型。默认值为 standard。设为 detailed 时会额外消耗 10 credits。
texture_quality=detailed 时的组合规则：
texture=false,pbr=false：将贴图放大至 4K，PBR 材质将被移除。仅v3.0-20250812可用。texture=false,pbr=true：基于当前贴图生成 PBR。texture=true,pbr=false：重新生成高清贴图，不含 PBR。texture=true,pbr=true：重新生成高清贴图并含 PBR。
注意
texture_quality=standard 时，texture=false 与 pbr=false 同时设置不被允许。
part_names: 从 网格分割 引用的部件名 text 列表，默认值为分割任务生成的全部部件名。
compress: 指定应用于贴图的压缩类型。可选值如下：
geometry: 应用基于几何的压缩以优化输出。默认使用 meshopt 压缩
bake: bool 值。设为 true 时会烘焙模型贴图，将高级材质效果合并到基础贴图中。默认值为 true。
返回值
task_id: 成功提交任务后的唯一标识。