图生模型(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: 成功提交任务后的唯一标识。