Rodin Texture

The Rodin texture function is designed to create texture based on specific mesh and settings.

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

To generate from a previously uploaded image, the texture_reference_file_name is fetched from the task detail API, corresponding to the images previously uploaded for the mesh generation stage.

For newly uploaded images, the texture_reference_file_index should always be set to 0, with each new image wrapped in FormData and each image binary appended under the field name images.

For settings, only parameters marked as Texture Generation Only need to be passed through.

Stage 2: Generate Rodin texture

post
Authorizations
Body
promptstring · max: 1024Optional
uuidstring · uuidRequired

task uuid

texture_upscalebooleanOptional
settingsall ofOptional

Pass a json string as the "settings" field in a form.

texture_reference_filenamestringOptional

Texture reference image filename in the storage.Leave it null if the user upload their own reference image

texture_reference_file_indexnumberOptional

The index of the texture reference image use uploaded.Leave it null if the user chooses an image in our storage as their own reference image

imagesstring · binary[]Optional
Responses
201Success
application/json
post
POST /api/task/rodin_texture HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: multipart/form-data
Accept: */*
Content-Length: 1183

{
  "prompt": "text",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "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,
    "pcd_condition_uncertainty": 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"
  },
  "texture_reference_filename": "text",
  "texture_reference_file_index": 1,
  "images": [
    "binary"
  ]
}
201Success
{
  "error": "NO_SUCH_TASK",
  "reference_filename": "text",
  "job": {
    "uuids": [
      []
    ],
    "subscription_key": "text"
  }
}

Last updated