Tripo Texture

v3.5-20260815

Texturização PBR para modelos 3D existentes.

Início rápido

Resolução máxima

Níveis de qualidade

fast / standard / detailed / 8K

Orientação

Texto / imagem / 2–4 vistas

Entrada

GLB/GLTF/FBX/OBJ/STL

Saída

Modelo com texturas PBR

Gere ou regenere texturas PBR para um modelo 3D existente: passe-o como task_id, arquivo enviado ou URL e guie o resultado com texto, uma única imagem ou várias vistas. O modelo de textura v3.5 adiciona controle de iluminação (delight), um modo Rápido e um alinhamento mais preciso à geometria, com resultados mais consistentes entre as vistas. A v3.5 precisa ser definida explicitamente: use model no endpoint de textura ou texture_version nos endpoints de geração; caso contrário, será usada a v3.0 padrão. A atualização se aplica apenas a novas tarefas — modelos e texturas existentes permanecem inalterados.

Controle de iluminação (delight, ativado por padrão): mantenha-o ativado em jogos realistas — cor base limpa sob a iluminação do Unity, Unreal ou Godot; desative-o em renderização, VFX e CG para preservar a iluminação estilizada
Modo Rápido: texture_quality=fast, mesmos créditos que standard
Melhor alinhamento à geometria: os detalhes ficam onde devem estar, com resultados mais consistentes entre as vistas
Orientação por texto, referência de estilo, imagem única ou 2–4 vistas; suporte a PBR, retexturização por partes e 8K

Preços

O preço é baseado no tipo de tarefa e em parâmetros específicos. A geração de texturas padrão ou o uso de opções de topologia premium acarreta custos adicionais.

Qualidade	Créditos
Rápido (fast)	10
Padrão (standard)	10
HD (detailed)	20
8K (extreme)	30

fast requer o modelo de textura v3.5-20260815; qualquer outra versão de textura retorna o erro 1004 em vez de usar standard como alternativa

Ao texturizar dentro de uma tarefa de geração, a saída com textura custa 10 créditos a mais do que apenas a geometria; HD acrescenta mais 10 e 8K, mais 20

Pontos finais

Clique em qualquer um dos cartões de endpoint abaixo para ir diretamente para a documentação detalhada do API e exemplos de código.

Textura

v3/models/texture

Texto para modelo 3D

v3/generation/text-to-model

Imagem para modelo 3D

v3/generation/image-to-model

Multivisualização para modelo 3D

v3/generation/multiview-to-model

Parâmetros

model

Versão do modelo de textura em /v3/models/texture: v3.0-20250812 (padrão, para modelos v3.0 / v3.1), v3.5-20260815 (mais recente; defina explicitamente) ou v2.5-20250123 (para modelos v2.5)

texture_version

Versão do modelo de textura nos endpoints de geração; mesmos valores de model. Se omitido, segue o modelo de geometria (v2.5 → v2.5; caso contrário, v3.0)

texture_quality

fast (apenas v3.5; mesmo tamanho e mesmos créditos que standard), standard (padrão), detailed (HD) ou extreme (8K)

delight

Remover a iluminação incorporada da imagem de referência (padrão: true). Mantenha ativado em jogos realistas e desative em renderização / CG para preservar a iluminação estilizada; apenas v3.5, versões anteriores o ignoram

texture_prompt

Orientação da textura: text (opcionalmente com style_image), image ou images (vista frontal obrigatória, pelo menos 2 vistas; recomenda-se usar objetos view-key ou 4 posições [frontal, esquerda, traseira, direita] com null para as vistas ausentes). text / image / images são mutuamente exclusivos

texture_alignment

original_image (padrão, fiel às cores da imagem de entrada) ou geometry (fiel à geometria gerada)

texture_seed

Semente aleatória; a mesma semente reproduz a mesma textura

pbr

Gerar materiais PBR (padrão: true)

part_names

Nomes das partes de uma tarefa de segmentação de malha; omita para texturizar todas as partes

bake

Fazer o bake de efeitos avançados de material nas texturas base para maior compatibilidade (padrão: true)

compress

geometry — compressão meshopt para um arquivo menor

Limites de taxa

Os limites de taxa garantem acesso justo e confiável ao API, colocando limites específicos em solicitações paralelas. Seu nível de uso determina o nível de definição desses limites.

Categoria	Limite de simultaneidade
Processamento de modelo (compartilhado com a conversão de formato)	5 tarefas paralelas

Instantâneos

Os instantâneos permitem bloquear uma versão específica do modelo para que o desempenho e o comportamento permaneçam consistentes.

v3.5-20260815	Mais recente: controle de iluminação e modo Rápido; defina explicitamente
v3.0-20250812	Padrão; para modelos gerados com v3.0 / v3.1
v2.5-20250123	Para modelos gerados com v2.5