Tripo
Tripo H3.1
tripo-h3.1/text-to-3d
Modelo de geração 3D de alto detalhe da Tripo, com suporte para gerar ativos 3D texturizados a partir de prompts de texto, de uma única imagem ou de múltiplas vistas, com número de faces e qualidade de textura ajustáveis e saída de materiais PBR, ideal para a produção de ativos como itens de jogo e visualização de produtos
Experimentar tripo-h3.1/text-to-3d
Entrada
Saída
Preços
tripo-h3.1/text-to-3d per model
+ $0.290 geometria mais refinada · se detalhada for selecionado
Visão geral
Este é um serviço de geração de modelos 3D a partir de texto: os desenvolvedores só precisam inserir uma descrição em linguagem natural para obter um ativo de modelo 3D com texturas. O prompt tem no máximo 1024 caracteres, permite excluir conteúdos indesejados por meio de um prompt negativo e possibilita definir separadamente a qualidade da geometria e da textura, se deve ser gerado material PBR, o limite máximo de triângulos e várias sementes aleatórias para reproduzir resultados. Os resultados gerados são adequados para protótipos de jogos, visualização de produtos, design conceitual e outros cenários que exigem transformar rapidamente ideias em texto em modelos 3D, voltados para desenvolvedores de conteúdo 3D, criadores independentes e equipes de design.
Destaques principais
- Geração de ativos 3D diretamente a partir de texto — basta inserir uma descrição para produzir um modelo 3D com geometria e texturas, eliminando a primeira etapa da modelagem manual.
- Qualidade de geometria e textura ajustável separadamente — tanto a qualidade da geometria quanto a da textura têm duas opções, padrão e refinada, permitindo equilibrar detalhes e volume de produção conforme o uso.
- Suporte a materiais PBR e alternância de texturas — por padrão, são gerados materiais e texturas PBR; também é possível desativar simultaneamente textura e PBR para manter apenas a malha geométrica pura, adaptando-se a diferentes fluxos downstream.
- Parâmetros de semente para reprodução de resultados — imagem conceitual, geometria e textura oferecem cada uma uma semente aleatória, facilitando repetir ou ajustar finamente os resultados gerados com as mesmas configurações.
Descrição das capacidades
Geração de modelos 3D a partir de descrição textual: constrói a geometria 3D com base no prompt, que tem no máximo 1024 caracteres; é possível complementar com um prompt negativo para excluir elementos indesejados, ideal para criar ativos conceituais do zero.
Controle do número alvo de triângulos: é possível especificar a quantidade alvo de triângulos por meio do parâmetro de limite de faces, com valor entre 1000 e 1,5 milhão (2 milhões para geometria refinada); quando não definido, o modelo decide de forma adaptativa, facilitando o alinhamento com as necessidades de renderização downstream.
Saída de materiais e texturas PBR: por padrão, são gerados materiais e texturas PBR; quando textura e PBR são desativados ao mesmo tempo, a saída é uma malha geométrica pura; a qualidade da textura pode ser padrão ou refinada, sendo que a opção refinada produz texturas de resolução mais alta.
Nível de detalhe da geometria ajustável: a qualidade da geometria pode ser escolhida entre padrão e refinada; a opção refinada adiciona detalhes de malha mais finos, adequada para ativos que exigem apresentação em close-up ou refinamento posterior.
Cenários de aplicação
- Produção rápida de modelos de itens para protótipos de jogos — designers ou desenvolvedores independentes descrevem a aparência do item em texto e geram um modelo 3D com texturas para importar na engine e realizar validação de protótipo e montagem de níveis.
- Criação de ativos conceituais para visualização de produtos — equipes de design geram modelos 3D a partir da descrição do produto, para apresentação inicial de propostas, rascunhos visuais de marketing e revisões internas.
- Iteração de design conceitual 3D — designers conceituais usam diferentes prompts e sementes para gerar variantes em lote, comparando rapidamente direções de modelagem e selecionando ativos para a fase de refinamento.
Limitações e recomendações de seleção
O prompt tem limite de 1 a 1024 caracteres; valores fora disso não podem ser enviados. O limite de faces aceita apenas inteiros entre 1000 e 1,5 milhão (2 milhões para geometria refinada); quando não definido, o modelo decide a quantidade de triângulos. Qualidade de textura e qualidade de geometria são opções de escolha única, sendo possível selecionar apenas uma delas por requisição. Com textura e PBR desativados, o produto é uma malha geométrica pura, sem mapas de superfície. Os parâmetros de semente servem para aumentar a reprodutibilidade, mas a mesma semente não garante resultados totalmente idênticos.
Novidades
Ver o changelog →- Novo modelo tripo-h3.1/multiview-to-3d disponível: Tripo H3.1 gera modelos 3D a partir de múltiplas vistas
- Novo modelo tripo-h3.1/text-to-3d disponível: Tripo H3.1 texto para 3D
- Novo modelo tripo-h3.1/image-to-3d disponível: Tripo H3.1 geração de 3D a partir de imagem
Perguntas frequentes
Ver todas as perguntas →-
Qual é o limite de faces? É possível chegar a 2 milhões?
Sim, o limite de face_limit é de 2 milhões de triângulos, mas só há suporte real até 2 milhões quando geometry_quality está definido como detailed; com standard, recomenda-se definir dentro de 1,5 milhão. Se face_limit não for informado, o modelo decide o número de faces de forma adaptativa.
-
Como faço para obter primeiro apenas uma geometria sem texturas?
Basta definir texture e pbr como false; quando pbr é true, as texturas são geradas obrigatoriamente. Se precisar de texturas mas não de material PBR, defina texture como true e pbr como false.
-
É necessário ativar parâmetros separados para geometria de alta densidade?
Definir geometry_quality como detailed acrescenta detalhes de malha mais finos e é também o pré-requisito para que a contagem de polígonos possa chegar a 2 milhões; se precisar de texturas mais refinadas, defina texture_quality como detailed. Ambos têm o padrão standard; ative-os apenas conforme os requisitos de close-up do ativo de destino.
-
Como reproduzir os resultados gerados para facilitar a comparação entre diferentes parâmetros?
A geometria e as texturas têm, cada uma, uma seed fixa: model_seed controla a geometria, texture_seed controla as texturas e, na geração de 3D a partir de texto, há ainda image_seed para controlar a imagem conceitual. Ao comparar ajustes de parâmetros, primeiro fixe as seeds e altere apenas um parâmetro, para poder determinar de qual item vem a diferença.
Criar uma tarefa de geração
https://api.hiapi.ai/v1/tasks Cabeçalhos
AuthorizationstringObrigatórioChave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API
Content-TypestringOpcionalO corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.
Idempotency-KeystringOpcionalChave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.
Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.
Corpo
modelstringObrigatórioValor fixo atual: tripo-h3.1/text-to-3d
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para tripo-h3.1/text-to-3d e a rota default — veja a tabela de parâmetros abaixo.
pbrbooleanOpcionalPadrão: trueDefine se deve gerar materiais PBR; aceita um valor booleano, padrão true; quando true, também gera mapas de textura.
promptstringObrigatóriominLength 1maxLength 1024Texto descritivo do objeto a ser gerado, por exemplo, um pequeno bule de cerâmica, usado como prompt de entrada para geração de 3D a partir de texto.
texturebooleanOpcionalPadrão: trueDefine se deve gerar textura para o modelo, padrão true. Observação: quando pbr é true, a textura é gerada obrigatoriamente; apenas quando texture e pbr são ambos definidos como false é que se obtém uma malha puramente geométrica.
face_limitintegerOpcionalmin 1000max 2000000Número alvo de faces triangulares, aceita inteiro, intervalo de 1000 a 1500000 (máximo de 2000000 quando geometry_quality=detailed); se omitido, o modelo decide o número de faces de forma adaptativa, o arquivo geralmente fica grande, e para exibição web recomenda-se cerca de 50000.
image_seedintegerOpcionalSemente aleatória para a geração da imagem conceitual, aceita inteiro, usada para reproduzir o resultado da mesma imagem conceitual.
model_seedintegerOpcionalSemente aleatória reproduzível para a geração da geometria, aceita inteiro, usada para reproduzir de forma estável o mesmo resultado geométrico.
texture_seedintegerOpcionalSemente aleatória reproduzível para a geração da textura, aceita inteiro, usada para reproduzir de forma estável o mesmo resultado de textura.
negative_promptstringOpcionalmaxLength 1024Prompt negativo, descreve o conteúdo que deve ser evitado durante a geração.
texture_qualitystringOpcionalPadrão: "standard"Nível de qualidade da textura, aceita string, padrão standard; o nível detailed gera texturas de resolução mais alta.
standarddetailedgeometry_qualitystringOpcionalPadrão: "standard"Nível de qualidade da geometria, aceita string, padrão standard; o nível detailed oferece detalhes de malha mais refinados.
standarddetailedcallbackobjectOpcional
Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.
Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.
urlstringObrigatórioObrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.
whenstringOpcionalPadrão: "final"Atualmente só há suporte a final — notifica tanto em success quanto em fail.
finalstoragestringOpcionalPadrão: "temp"Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.
temppersistentExemplos de requisição
# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1/text-to-3d",
"input": {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "tripo-h3.1/text-to-3d",
input: {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "tripo-h3.1/text-to-3d",
"input": {
"pbr": True,
"prompt": "…",
"texture": True,
"texture_quality": "standard",
"geometry_quality": "standard"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obter detalhes da tarefa
https://api.hiapi.ai/v1/tasks/:id Campos da resposta
taskIdstringObrigatórioID da tarefa, sempre com prefixo tk-hiapi-.
modelstringObrigatórioNome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.
routestringOpcionalPresente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.
statusstringObrigatórioEstado da tarefa.
queued Na fila, ainda não iniciada.
handling Em processamento.
archiving Processamento concluído, preparando artefatos.
success Terminal: concluído, artefatos disponíveis (retorna output).
fail Terminal: falha (retorna error).
Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.
creatednumberObrigatórioMomento de criação da tarefa (segundos Unix).
completednumberObrigatórioSegundos Unix do estado terminal; 0 enquanto não terminal.
outputarrayOpcional
Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).
Array [ object ]
Itens do array
urlstringObrigatórioURL do artefato, baixável diretamente.
typestringObrigatórioValores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.
expireAtnumberObrigatórioSegundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.
errorobjectOpcional
Presente apenas com status == fail.
codestringObrigatórioCódigo de erro de negócio.
messagestringObrigatórioDescrição do erro.
Exemplos de resposta
Sucesso
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Em processamento (não final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Falhou
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artigos
Ver todos os artigos →-
Tutorial
Cenários práticos do Tripo H3.1: 5 usos de alto valor e pontos de implementação
De texto para 3D à reconstrução multivisão: escolha o modo e os parâmetros certos para cada cenário de negócio
-
Guia de uso
Guia de introdução ao Tripo H3.1: três modos de entrada, parâmetros e como escolher o preço
Decisão de integração e controle de custos na geração 3D para desenvolvedores
-
Avaliação comparativa
Comparativo e guia de seleção do Tripo H3.1: como escolher entre os três caminhos de geração 3D e como economizar
A partir do formato de entrada, do refinamento geométrico e das chaves de PBR/textura, faça uma ponderação de preço e capacidade orientada a desenvolvedores