多视图图像

用于生成和编辑下游 3D 工作流所需的多视图参考图像。

生成多视图图像

任务离开等待队列后通常会在几秒内完成。该任务每次请求消耗 10 积分。

接口地址

参数

必填参数

type: Must be set to generate_multiview_image.

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。

返回值

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

行为说明

generate_multiview_image 默认并发限制为 1。详见 Rate limits。

output 中任务结果字段说明见 Get your task result。

编辑多视图图像

任务离开等待队列后通常会在几秒内完成。该任务按编辑的 view 计费，每个消耗 5 积分。

接口地址

参数

必填参数

type: Must be set to edit_multiview_image.

original_task_id: 由 generate_multiview_image 生成的 task_id。

prompts: 指定视图图像的编辑提示列表。

• prompt: 对选中视图的编辑指令。
• view: 要编辑的视角。可选值为 front、left、back、right。

返回值

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

行为说明

edit_multiview_image 默认并发限制为 1。详见 Rate limits。

output 中任务结果字段说明见 Get your task result。