图生模型（v1.4-20240625）

本页列出 image_to_model 在 model_version 为 v1.4-20240625 时支持的全部参数。

何时使用 v1.4

• 仅在你需要兼容旧版集成行为时使用 v1.4。
• 新接入建议优先选择 H3、H2、P1 或 Turbo-v1.0。

接口地址

参数

必填参数

type: 该字段必须设置为 image_to_model。

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: 应设置为 v1.4-20240625。

常用参数

model_seed: 一个 integer 值；若不设置将随机生成。它是模型生成的随机种子。对于 model_version>=v2.0-20240919 或 Turbo-v1.0-20250506，该种子会控制几何生成过程，使用相同种子可得到一致的模型。

enable_image_autofix: bool 值，用于控制是否优化输入图像以提升生成效果。开启后处理时间会更长。默认值为 false。

进阶参数

本版本无进阶参数。

返回值

task_id: 成功提交任务后的唯一标识。