Tripo H3.1 API

Sobre o Tripo H3.1

Formas 3D precisas e cores fiéis a partir de uma foto de produto.

Chame com o nome de modelo tripo/h3.1/image-to-3d em POST /jobs/createTask, a partir de US$ 0,432.

Introdução

Tripo H3.1 é o modelo de imagem para 3D que a Tripo AI apresentou em março de 2026 para ativos de nível de produção, com geometria mais nítida, melhor alinhamento com a imagem de entrada e texturas de qualidade superior às dos seus modelos anteriores da série H. Você envia uma imagem (image_url) e recebe um arquivo glTF binário (.glb). Diferente de conversores de um único controle, cada etapa do pipeline fica exposta: texturizar ou não a malha, adicionar mapas PBR, texturas HD, geometria detalhada, topologia de quadriláteros, uma contagem alvo de faces, escala real, a orientação final e duas seeds separadas. Não há prompt.

Principais recursos

Uma forma que segue a imagem

No nosso teste com uma bota, o modelo manteve as proporções da foto e colocou a argola do calcanhar, os ganchos dos cadarços e o solado nos lados corretos, mesmo com a foto mostrando apenas a frente. O resultado texturizado levou o couro desgastado, os cadarços vermelhos e as costuras para a malha.

Texturas que você liga e melhora

As texturas vêm ativadas por padrão e em um conjunto PBR completo. Nosso arquivo com configurações padrão tinha, em um único material, um mapa de cor base de 2048 pixels, um mapa de metal-rugosidade e um mapa de normais.

Topologia e tamanho sob controle

face_limit limita o número de faces entre 1.000 e 2.000.000, quad_mesh muda para polígonos de quatro lados para edição em uma ferramenta de modelagem, e geometry_quality: detailed dedica mais processamento aos detalhes finos da superfície. auto_size ajusta a malha para dimensões reais e model_orientation: align_image a orienta para combinar com a imagem.

O que medimos

Com as configurações padrão, uma vista frontal de uma bota de couro (1024×1024) voltou em 167 segundos como um GLB de 45,8 MB com 1.471.382 triângulos e três texturas. Essa densidade é o motivo para definir face_limit em tudo que for exibido em um navegador.

Parâmetros da requisição

Preços

Os preços são em USD. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.

Antes de executar, envie o mesmo corpo de requisição para POST /jobs/quote para ver o custo estimado e o máximo em USD. O orçamento não executa tarefas nem debita seu saldo.

Casos de uso

Ativos para jogos, AR e cenas em tempo real

Defina face_limit conforme o orçamento da sua cena, ative quad_mesh se o ativo for editado depois e mantenha o PBR ligado para que o modelo reaja à iluminação da cena.

Visualização de produto e impressão

Para um visualizador de produto, mantenha as texturas ativas e use texture_quality: detailed quando rótulos ou costuras precisarem ficar legíveis. Para impressão 3D ou escultura, desative as duas chaves de textura e defina auto_size para que a malha saia em escala realista.

Guia de prompts e dicas avançadas

Comece com uma imagem limpa

Um único sujeito, inteiro no quadro, sobre fundo liso. Uma vista em três quartos informa melhor a profundidade do que uma vista frontal reta. JPEG, PNG ou WebP de até 10 MB.

Ative só o que precisar

Faça uma primeira passada com os padrões e um face_limit, e melhore apenas a etapa que ficou aquém.

Itere com as duas seeds

seed fixa a geometria e texture_seed fixa a textura. Mantenha seed e mude texture_seed para testar superfícies novas na mesma forma, ou mantenha texture_seed enquanto explora formas.

Confira o lado oculto

Abra o GLB em um visualizador e gire-o por completo antes de usar. Se o lado não visível estiver errado, um ângulo de câmera diferente na imagem de origem ajuda mais do que qualquer configuração.

Início rápido da API

Chame a API do Tripo H3.1 em três passos

1. Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow-. As chamadas usam seu saldo separado em dólares americanos.
2. Envie a requisição. Faça POST /jobs/createTask com model tripo/h3.1/image-to-3d e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
3. Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/h3.1/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_texture": true,
    "generate_pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "model_orientation": "default"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.

Perguntas sobre a API do Tripo H3.1

Outras APIs de imagem

• API do Seed3D 2.0Modelos 3D com texturas ricas a partir de uma imagem, ótimo para personagensA partir de US$ 0,48 por geração

Mais sobre o Tripo H3.1

Experimente

Tripo H3.1: gerador de imagens com IA onlineCrie imagens com o Tripo H3.1 na PopNow

Documentação

ID do modelo e esquema de entrada do Tripo H3.1 na documentação da APIPrimeiros passos com a API da PopNow: envie sua primeira requisiçãoGuia de geração de imagens com a API da PopNowWebhooks: receba os resultados do Tripo H3.1 sem polling