Texture — Tripo Developers

http

Base URL: https://openapi.tripo3d.ai/v3

Endpoint: POST /models/texture

Regenerate texture maps for an existing model.

Note

This endpoint requires an API Key. Include it in the Authorization header as Bearer {api_key}.
This is an asynchronous API. After submitting the request, use the Task Query API to poll for results, or configure a Webhook to receive automatic notifications when the task completes.

Request Parameters

Request Body

inputstringRequired

Model source. Accepts task_id, file_token, or URL. Accepts the following input types:

Choose exactly one of the following — do not pass multiple types simultaneously.

task_id — The task ID returned by a previous 3D generation task (text_to_model, image_to_model, or multiview_to_model). The system automatically uses the 3D model output from that task.
Example: task_abc123
file_token — Upload a 3D model file via the File Upload API first, then pass the returned token.
Example: file_abc123
URL — A publicly accessible direct link to a 3D model file.
Example: https://example.com/model.glb

Notes

Supported formats: GLB, GLTF, FBX, OBJ, STL
Max file size: 150 MB

modelstringdefault: v3.0-20250812

Texture model version. Choose based on the generation model used for the source 3D model:

v3.0-20250812 — default. Recommended for models generated with v3.0-20250812 or v3.1-20260211.
v2.5-20250123 — recommended for models generated with v2.5-20250123.

texture_promptobject

Texture guidance input. Optional if the model was generated via Tripo.

text / image / images are mutually exclusive — use exactly one (style_image may accompany text).

text — A text prompt describing the desired texture style.
Example: {"text": "worn leather with scratches"}
style_image — A reference image to influence artistic style. Only used with text mode. Accepts file_token or url. Recommended resolution: at least 256×256 px.
Example: {"text": "cyberpunk style", "style_image": {"url": "https://..."}}
image — A single reference image for texture generation. Accepts file_token or URL.
images — A list of exactly 4 reference images in the order [front, left, back, right] for multi-angle texture guidance.

Notes

When initiating a texture task based on an existing task_id, it is strongly recommended to re-supply the reference image in this request.
text, image, and images are mutually exclusive.
Optional style_image can be added alongside text to influence artistic style.

pbrbooleandefault: true

Enable PBR material generation.

texture_seedinteger

Random seed for texture generation. Using the same seed will produce identical textures. If not set, a random seed will be used each time. To get a model with different textures but the same geometry, keep model_seed unchanged and vary texture_seed.

texture_alignmentstringdefault: original_image

Texture alignment priority.

original_image — prioritize matching the input image colors.
geometry — prioritize matching the generated geometry.

texture_qualitystringdefault: standard

Texture quality level.

standard — balanced quality and speed.
detailed — higher fidelity, slower generation.
extreme — 8K textures, highest fidelity. Costs additional credits compared to detailed.

part_namesstring[]

List of part names from a previous mesh segmentation task. If omitted, all parts are textured.

compressstring

Compression type.

geometry — meshopt compression for reduced file size.

Notes

The following parameters are only valid when model ≥ v3.0-20250812: texture_quality, geometry_quality, auto_size, quad, smart_low_poly, generate_parts, compress.

bakebooleandefault: true

Bake advanced material effects into base textures for broader compatibility.

Examples

Basic (v2.5 model)

{
  "input": "task_abc123",
  "model": "v2.5-20250123",
  "texture_quality": "detailed",
  "pbr": true
}

For v3.x model

{
  "input": "task_abc123",
  "model": "v3.0-20250812",
  "texture_quality": "detailed",
  "pbr": true
}

With prompt

{
  "input": "task_abc123",
  "model": "v3.0-20250812",
  "texture_prompt": {
    "text": "worn leather with scratches"},
  "texture_quality": "detailed"}

Create task

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}

Task result

{
  "code": 0,
  "data": {
    "task_id": "task_abc123",
    "type": "text_to_model",
    "status": "success",
    "progress": 100,
    "output": {
      "model_url": "https://cdn.tripo3d.ai/output/model_pbr.glb",
      "rendered_image_url": "https://cdn.tripo3d.ai/output/preview.png"},
    "credits_consumed": 100,
    "created_at": "2026-04-28T12:00:00Z",
    "completed_at": "2026-04-28T12:01:30Z"}
}

Texture

curl --request POST \
  --url https://openapi.tripo3d.ai/v3/models/texture \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "input": "task_abc123",
  "model": "v2.5-20250123",
  "texture_quality": "detailed",
  "pbr": true
}'

200Response

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}