Tripo Texturing

Tripo texture model API reference. Apply or regenerate textures on existing 3D models with text prompts, reference images, and style transfer.

Texture Model

POST

/v1/3d-models/tripo/texture-model/

Apply or regenerate textures on an existing 3D model. Supports text prompts, reference images, and style transfer via a style image. Upload a model file directly or provide a URL to a publicly accessible model.

Request

curl -X POST https://api.3daistudio.com/v1/3d-models/tripo/texture-model/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model_url=https://example.com/model.glb" \
  -F "prompt=rustic wooden texture with visible grain" \
  -F "texture_quality=standard" \
  -F "pbr=true"

Response

{
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-03-26T12:00:00Z"
}

Parameters

Parameter	Type	Required	Default	Description
model	file	Conditional	—	3D model file upload. Required if model_url is not provided.
model_url	string	Conditional	—	URL to a publicly accessible 3D model. Required if model is not provided.
prompt	string	No	—	Text description for texture generation. Max 1024 characters. Cannot be combined with image_url.
image_url	string	No	—	Reference image URL for texture generation. Cannot be combined with prompt.
image	file	No	—	Reference image file upload.
style_image_url	string	No	—	Style reference image URL for style transfer. Only with a text prompt. Adds 10 credits.
style_image	file	No	—	Style reference image file upload. Only with a text prompt. Adds 10 credits.
texture_model	string	No	"3.5"	Texture model version: "3.5" (newest), "3.0" or "2.5".
texture_quality	string	No	"standard"	Texture quality: "fast" (3.5 only, same cost as standard), "standard", "detailed" or "extreme".
lighting_removal	boolean	No	true	3.5 only. Removes baked-in lighting from the reference image before texturing.
pbr	boolean	No	true	Generate PBR material maps.
texture	boolean	No	—	Deprecated and ignored. The endpoint always generates textures from the prompt or reference image.
texture_alignment	string	No	"original_image"	Texture alignment mode: "original_image" or "geometry".
texture_seed	integer	No	random	Seed for reproducible texture generation.
compress	string	No	—	Compression mode. Only option: "geometry".
bake	boolean	No	true	Bake textures into the model.

Texture Prompt Options

You can guide texture generation with a text prompt or a reference image — but not both. Optionally, a style image can be added alongside a text prompt to transfer artistic style.

Request

// Option A: Text prompt
{
  "model_url": "https://example.com/model.glb",
  "prompt": "brushed copper with green patina"
}

// Option B: Reference image
{
  "model_url": "https://example.com/model.glb",
  "image_url": "https://example.com/reference.png"
}

// Text prompt + style transfer
{
  "model_url": "https://example.com/model.glb",
  "prompt": "metallic surface",
  "style_image_url": "https://example.com/art-style.png"
}

Checking Status

GET

/v1/generation-request/<task_id>/status/

Poll this endpoint with the task_id from the generation response. When status is "FINISHED", the results array contains a download URL for your textured model. Results expire after 24 hours.

Request

curl https://api.3daistudio.com/v1/generation-request/YOUR_TASK_ID/status/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "status": "FINISHED",
  "progress": 100,
  "failure_reason": null,
  "results": [
    {
      "asset": "https://storage.3daistudio.com/assets/textured-model.glb",
      "asset_type": "3D_MODEL",
      "metadata": null
    }
  ]
}

Credit Costs

Credits are deducted when you submit a request. If generation fails, credits are refunded automatically.

Configuration	Credits
Standard quality	20
Detailed quality	40
+ Style image	+10

Errors

Common errors for the Tripo texture model endpoint.

Status	Error Code	Description
400	VALIDATION_FAILED	Missing or invalid parameters (e.g. prompt and image_url both provided).
401	INVALID_API_KEY	Invalid or missing API key.
402	INSUFFICIENT_CREDITS	Not enough credits. Purchase more credits.
429	RATE_LIMITED	Rate limit exceeded. Wait and retry.