Generate Texture

Texture Generation

The API for Rodin generating textures

post

This API will generate textures and 3D model for the given images, prompt and 3D model.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

imagestring · binaryRequired

promptstringOptional

modelstring · binaryRequired

seednumberOptional

geometry_file_formatstring · enumOptionalDefault: glbPossible values:

materialstring · enumOptionalDefault: PBRPossible values:

escorenumberOptionalDefault: 3.5

reference_scalenumberOptionalDefault: 1

resolutionstring · enumOptionalDefault: BasicPossible values:

Responses

201Success

application/json

post

/api/v2/rodin_texture_only

CLI

curl https://api.hyper3d.com/api/v2/rodin_texture_only \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--header 'Content-Type: multipart/form-data' \
--file 'image=@/path/to/your/image.png' \
--file "model=@/path/to/your/model.obj" \ 
--file "geometry_file_format=glb" \
--file "material=PBR" \
--file "escore=3.5" \
--file "reference_scale=1" \
--file "resolution=Basic" \
...

201Success

{
  "error": "text",
  "message": "text",
  "uuid": "text",
  "submit_time": "text",
  "jobs": {
    "uuids": [
      "text"
    ],
    "subscription_key": "text"
  }
}

Texture Generation

Use this API to submit an asynchronous task to our server. You will get a task UUID from the API which can be used to check the status of the the task and download the result when the task is ready.

Pricing

Each call costs 0.5 credits.

Request

Note: All requests to this endpoint must be sent using multipart/form-data to properly handle the file uploads and additional parameters required for the mesh and texture generation process.

Authentication

This API uses bearer key for authentication. You need to include a valid token in the Authorization header for all requests.

Authorization: Bearer RODIN_API_KEY

Body

Parameter	Type	Description
image	file/Binary	Required. One binary image file to serve as texture references.
prompt	string	Optional. A texture description to guide texture generation.
model	file/Binary	Required. One binary 3D model file to process. Maximum file size: 10MB
seed	number	Optional. A seed value for randomization in the mesh generation, ranging from 0 to 65535 (both inclusive). If not provided, the seed will be randomly generated.
reference_scale	number	Optional. Represents the reference scale of texture generation process.
geometry_file_format	string	Optional. The format of the output geometry file. Possible values are glb, usdz, fbx, obj, and stl. Default is glb.
material	string	Optional. The material type. Possible values are PBR and Shaded. Default is PBR..
resolution	string	Optional. The resolution of the output texture. Possible values are Basic and High. Default is Basic.

Examples

Request with cURL

export RODIN_API_KEY="your api key"
curl https://api.hyper3d.com/api/v2/rodin_texture_only \
  -H "Authorization: Bearer ${RODIN_API_KEY}" \
  -F "image=@/path/to/your/image.jpg" \
  -F "model=@path/to/your/model.obj"  \
  -F "reference_scale=1.0" \
  -F "geometry_file_format=glb" \
  -F "material=PBR" \
  -F "resolution=High"
unset RODIN_API_KEY

Request with Python 3

Response