Redo

The Rodin redo function is designed to re-generate 3D meshes from images based on new prompts or settings.

The request body should be wrapped in the FormData instead of plain JSON, while settings should be parsed to JSON.

Redo Rodin generation with new prompt and weights.

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

promptstringOptional

reference_imagestringOptional

texture_upscalebooleanOptional

uuidstringRequired

Responses

201Success

application/json

post

/api/task/rodin_update

HTTPcURLJavaScriptPython

POST /api/task/rodin_update HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1425

{
  "prompt": "text",
  "reference_image": "text",
  "texture_upscale": true,
  "settings": [
    {
      "bbox_condition": [
        1
      ],
      "bbox_condition_cfg": true,
      "bbox_condition_weight": 1,
      "voxel_condition": "text",
      "voxel_condition_cfg": true,
      "voxel_condition_weight": 1,
      "pcd_condition": [
        [
          1
        ]
      ],
      "pcd_condition_cfg": true,
      "pcd_condition_weight": 1,
      "skeleton_condition": [
        {
          "name": "text",
          "parent": 1,
          "position": [
            1
          ]
        }
      ],
      "skeleton_condition_cfg": true,
      "skeleton_condition_weight": 1,
      "view_weights": [
        1
      ],
      "image_label": [
        "F"
      ],
      "condition_mode": [
        "fuse"
      ],
      "generation_mode": [
        "Fast"
      ],
      "escore": 1,
      "seed": 1,
      "reference_scale": 1,
      "fast_texture": true,
      "inference_steps": 50,
      "guidance_scale": 7.5,
      "negative_prompt": "text",
      "rest_bias": 0,
      "sharp_bias": 0,
      "image_mode": "recon",
      "enable_advance_option": true,
      "height": 1,
      "face_enhance": true,
      "allow_face_enhance": true,
      "default_face_enhance": true,
      "align_ground": true,
      "mesh_export_type": "Quad",
      "mesh_smooth": true,
      "mesh_simplify": true,
      "lineart_enable": true,
      "lineart_weight": 1,
      "quality_override": 1,
      "resolution": "Basic",
      "geometry": "Base",
      "geometry_file_format": "glb",
      "material": "PBR"
    }
  ],
  "conditions": [
    {
      "bbox_condition": [
        1
      ],
      "bbox_condition_cfg": true,
      "bbox_condition_weight": 1,
      "voxel_condition": "text",
      "voxel_condition_cfg": true,
      "voxel_condition_weight": 1,
      "pcd_condition": [
        [
          1
        ]
      ],
      "pcd_condition_cfg": true,
      "pcd_condition_weight": 1,
      "skeleton_condition": [
        {
          "name": "text",
          "parent": 1,
          "position": [
            1
          ]
        }
      ],
      "skeleton_condition_cfg": true,
      "skeleton_condition_weight": 1
    }
  ],
  "uuid": "text"
}

201Success

{
  "error": "NO_SUCH_TASK",
  "job": {
    "uuids": [
      []
    ],
    "subscription_key": "text"
  }
}