Tripo3D

编辑多视图

http
Base URL: https://openapi.tripo3d.ai/v3
Endpoint: POST /generation/edit-multiview
编辑现有的多视图图像。在所有视图间应用一致的修改。
注意
  • 此接口需要 API Key 认证。请在 Authorization 请求头中传入 Bearer {api_key}。
  • 此接口为异步 API。提交请求后，请使用 任务查询接口 轮询获取结果，或配置 Webhook 接收任务完成时的自动通知。

请求参数

请求体

inputstring必选
要编辑的多视图源图像。接受以下输入类型：
以下三种方式任选其一，不可同时传入多种类型。
  • task_id：此前多视图生成任务返回的任务 ID。系统会自动使用输出的多视图图像。如需先生成多视图图像，请使用 图像生成多视图 API。
    示例： task_abc123
  • file_token：先通过文件上传 API上传多视图图像。
    示例： file_abc123
  • URL：可公开访问的多视图图像直链。
    示例： https://example.com/multiview.png
promptsobject[]必选
编辑指令列表，每条指令针对一个特定视角。每个元素包含：
  • prompt：描述所需变更的编辑指令。
    示例： 将衬衫颜色改为红色
  • view：要应用编辑的视角。
    • front：正面
    • left：左侧
    • back：背面
    • right：右侧

示例

编辑视图
{
  "input": "task_abc123",
  "prompts": [
    {
      "prompt": "change the shirt color to red",
      "view": "front"},
    {
      "prompt": "add a logo on the back",
      "view": "back"}
  ]
}
创建任务
{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}