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/api/task/rodin_texture

Authorization

bearer

Body

multipart/form-data

promptstring

uuid*string

task uuid

settingsall of

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

texture_reference_filenamestring

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

texture_reference_file_indexnumber

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

imagesarray of string (binary)

Response

201

Body

application/json

errorenum

OKINVALID_REQUESTUSER_NOT_FOUNDGROUP_NOT_FOUNDPERMISSION_DENIEDINSUFFICIENT_BALANCENO_SUCH_TASKTASK_INCOMPLETESUBSCRIPTION_REQUIREDINTERNAL_SERVER_ERROR

reference_filenamestring

jobJobSubmissionResponse (object)

Request

JavaScriptCurlPython

const response = await fetch('/api/task/rodin_texture', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer JWT",
      "Content-Type": "multipart/form-data"
    },
    body: JSON.stringify({
      "uuid": "text"
    }),
});
const data = await response.json();

Response

201

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