Tripo
Tripo H3.1
tripo-h3.1/multiview-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/multiview-to-3d
Entrada
Envie, em ordem, diferentes ângulos do mesmo objeto: frontal (obrigatório), esquerda, traseira e direita, no mínimo 2 e no máximo 4 imagens; suporta apenas JPG, PNG e WEBP.
Saída
Preços
tripo-h3.1/multiview-to-3d per model
+ $0.290 geometria mais refinada · se detalhada for selecionado
Visão geral
Ferramenta de geração de modelos 3D a partir de múltiplas vistas, que recebe de 2 a 4 imagens do mesmo objeto em ângulos diferentes e gera um ativo 3D com estrutura geométrica. As imagens de entrada são fornecidas na ordem frente, esquerda, trás e direita, sendo adequada para profissionais de arte de jogos e visualização de produtos que possuem fotos de produtos ou material de captura circular, convertendo rapidamente objetos reais ou esboços de design em modelos 3D que podem ser editados, renderizados ou exportados posteriormente.
Destaques principais
- Estrutura geométrica restringida por múltiplas vistas — é possível modelar com 2 a 4 imagens do mesmo objeto em pontos de vista diferentes, restringindo o contorno de forma mais completa do que com uma única imagem.
- Precisão de geometria e textura ajustável — a qualidade geométrica e a qualidade de textura podem ser definidas em dois níveis, padrão ou detalhado (standard / detailed), equilibrando velocidade e detalhe conforme o uso.
- Controle flexível de materiais e número de faces — é possível ativar ou desativar textura e material PBR, bem como especificar uma contagem alvo de triângulos entre 1000 e 1,5 milhão (2 milhões no caso de geometria detalhada).
- Suporte a estilo e reprodutibilidade — a orientação pode ser alinhada à imagem de entrada, e geometria e textura têm cada uma sua semente aleatória, facilitando fixar o resultado.
Descrição das capacidades
Modelagem a partir de múltiplas imagens: envie de 2 a 4 imagens HTTPS descrevendo o mesmo objeto na ordem frente, esquerda, trás e direita para gerar o ativo de modelo 3D correspondente.
Textura e material PBR: por padrão, gera textura e material PBR; também é possível desativar ambos ao mesmo tempo e manter apenas a malha puramente geométrica; a qualidade da textura pode ser padrão ou detalhada.
Controle do limite de faces: é possível especificar uma contagem alvo de triângulos entre 1000 e 1,5 milhão (2 milhões no caso de geometria detalhada); se não for preenchido, o modelo decide de forma adaptativa, facilitando adequar ao orçamento do pipeline posterior.
Orientação e modo de alinhamento: ao escolher a orientação "alinhar à imagem de entrada" (align_image), o modelo gira automaticamente para corresponder à imagem de entrada; o alinhamento de textura (texture_alignment) pode ser definido para aderir à imagem original ou ao corpo geométrico.
Reprodutibilidade por semente aleatória: defina sementes inteiras separadamente para geometria e textura, ajudando a reproduzir o resultado da geração com as mesmas entradas e configurações.
Cenários de aplicação
- Conversão de fotos de produto em captura circular para ativos 3D — equipes de e-commerce ou de produtos usam fotos de produto em múltiplos ângulos como entrada para obter um modelo 3D com textura, utilizado em exibição 3D na web ou em imagens de marketing.
- Protótipos de arte para jogos e cenários — artistas usam esboços de design em múltiplas vistas de personagens ou adereços para gerar malhas com número médio de faces, importando-as no motor como adereços de primeiro plano ou ativos de prova de conceito.
- Organização de material de digitalização e referência para retopologia — equipes de ativos digitais usam imagens de digitalização em múltiplas vistas para gerar um modelo de referência com textura, servindo como base de comparação para reconstrução manual ou criação de materiais.
Limitações e recomendações de escolha
As imagens devem ser endereços HTTPS, e cada requisição deve fornecer de 2 a 4 vistas do mesmo objeto; fora desse intervalo não é possível enviar. A contagem alvo de triângulos é limitada entre 1000 e 1,5 milhão (2 milhões no caso de geometria detalhada); quanto maior o número de faces, maiores as exigências de desempenho no processamento posterior. Textura e material PBR podem ser desativados ao mesmo tempo; nesse caso, é gerada apenas a malha puramente geométrica. O nível detalhado (detailed) acrescenta detalhes, mas também prolonga o tempo de processamento. A semente aleatória apenas ajuda na reprodução, não garantindo que gerações repetidas sejam totalmente idênticas.
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/multiview-to-3d
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para tripo-h3.1/multiview-to-3d e a rota default — veja a tabela de parâmetros abaixo.
pbrbooleanOpcionalPadrão: trueDefine se as texturas de material PBR devem ser geradas; quando true, as texturas também são produzidas, padrão true.
texturebooleanOpcionalPadrão: trueDefine se as texturas devem ser geradas para o modelo, padrão true. Observação: quando pbr é true, as texturas são geradas obrigatoriamente; somente 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, valor inteiro, intervalo 1000–1500000 (máximo de 2000000 quando geometry_quality=detailed); quando omitido, o modelo decide o número de faces de forma adaptativa, e o arquivo costuma ser grande; para exibição na web, recomenda-se cerca de 50000.
image_urlsarrayObrigatóriominItems 2maxItems 4Array de URLs HTTPS de 2–4 imagens de vistas do mesmo objeto, ordenadas como frente, esquerda, trás, direita; a primeira deve ser a vista frontal.
Array [ string ]
model_seedintegerOpcionalSemente aleatória da geração de geometria, valor inteiro, usada para reproduzir o mesmo resultado geométrico.
orientationstringOpcionalPadrão: "default"Configuração de orientação do modelo, valor string; quando definida como align_image, o modelo é rotacionado automaticamente para alinhar com a imagem de entrada; padrão default.
defaultalign_imagetexture_seedintegerOpcionalSemente aleatória da geração de textura, valor inteiro, usada para reproduzir o mesmo resultado de textura.
texture_qualitystringOpcionalPadrão: "standard"Nível de qualidade da textura, valor string; o nível detailed gera texturas de resolução mais alta; padrão standard.
standarddetailedgeometry_qualitystringOpcionalPadrão: "standard"Nível de qualidade da geometria, valor string; o nível detailed oferece detalhes de malha mais refinados; padrão standard.
standarddetailedtexture_alignmentstringOpcionalPadrão: "original_image"Modo de alinhamento da textura com a imagem de entrada, valor string, padrão original_image.
original_imagegeometrycallbackobjectOpcional
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/multiview-to-3d",
"input": {
"pbr": true,
"texture": true,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
}' 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/multiview-to-3d",
input: {
"pbr": true,
"texture": true,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
}),
});
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/multiview-to-3d",
"input": {
"pbr": True,
"texture": True,
"image_urls": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
},
)
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 →-
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
-
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
-
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