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

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

promptstring · max: 1024Optional

uuidstring · uuidRequired

task uuid

texture_upscalebooleanOptional

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

errorstring · enumOptionalPossible values:

reference_filenamestringOptional

post

/api/task/rodin_texture

HTTPcURLJavaScriptPython

POST /api/task/rodin_texture HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 1153

{
  "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,
    "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"
  }
}