Skip to content

图生模型(v1.4-20240625)

本页列出 image_to_modelmodel_versionv1.4-20240625 时支持的全部参数。

何时使用 v1.4

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

接口地址

参数

必填参数

type: 该字段必须设置为 image_to_model

file: 指定图像输入。

  • type: 表示文件类型。虽然当前不会严格校验,但强烈建议填写正确的文件类型。
  • file_token: 从上传接口获得的标识,请参考直接上传部分。urlobject 互斥
  • url: 图像的直链 URL。支持 JPEG 和 PNG,最大 20MB。file_tokenobject 互斥
  • object (强烈推荐): 从上传接口获取的对象信息,请参考 Upload in STSurlfile_token 互斥
    • bucket: 通常固定为 tripo-data
    • key: 返回值中的 resource_uri

model_version: 应设置为 v1.4-20240625

常用参数

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

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

进阶参数

本版本无进阶参数。

返回值

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