Texture 3D Asset

Learn how to texture an asset with Polyhive

Texture a 3D model with Polyhive

POST https://prod.polyhive.ai/api/content/retexture

Through this endpoint, you can texture an asset that has already been uploaded to Polyhive using the Polyhive asset ID.

You need to provide this job info and these job parameters, formatted as a JSON:

job_name (string): The name of the texture job. version_id (string): The ID of the asset obtained from the upload asset endpoint. Received from the file upload endpoint text_prompt (string): The text prompt for the texture generation. seed (int): The seed value for randomization. If set to -1, a random seed value will be generated. negative_prompt (string): The negative text prompt for the texture generation. material_maps (bool): Flag indicating whether to generate normal, metallic, and roughness material maps. preserve_uvs (bool): Flag indicating whether to preserve existing model UV map during texture generation. zy_symmetry (bool): Flag indicating whether to apply ZY symmetry (left same as right) during texture generation.

An example of a request to this endpoint through curl, for texturing an asset with asset_id 4c5dc77f-fd39-4859-a927-431bdba564f4:

curl -X POST -H "x-api-key: <YOUR API KEY>" -H "Content-Type: application/json" -d '{ "job_name": "testjob", "version_id": "4c5dc77f-fd39-4859-a927-431bdba564f4", "text_prompt": "A green t-shirt, cartoon style", "job_params": { "seed": "12335", "negative_prompt": "low quality, bad", "material_maps": "False", "preserve_uvs": "True", "zy_symmetry": "False" } }' https://prod.polyhive.ai/api/content/retexture

Headers

Name	Type	Description
X-API-KEY*	uuid	Your API Key, created through the dashboard
Content-Type*	String	The content type of the request, set to "application/json".

Request Body

Name	Type	Description
texture_job*	json	The job info and parameters, formatted as a json file.

200: OK The Polyhive job id (uuid) for the submitted texture job

{"job_id":"523f5c2a-c3a3-483a-ae96-6bb818d7d5c3"}