Skip to main content
A geração 3D é assíncrona. POST /v1/3d/generations cria uma tarefa TokenLab; respostas de status concluído retornam ativos de modelo para download, como model_url e, quando disponíveis, URLs específicas de formato.

​
Escolha O Tipo De Entrada

Consulte o catálogo de modelos antes de decidir quais opções expor: Use o tipo de entrada em vez de um campo operation neste endpoint. Os metadata do modelo informam capacidades 3D como text-to-3d e/ou image-to-3d; 3d-generation não é uma operação pública de requisição.
Exemplos atuais da Tripo incluem tripo-h3.1 para fluxos text/image-to-3D de alta qualidade e tripo-p1.0 para geracao de ativos 3D com perfil de producao. Use a Models API para confirmar tipo de entrada e formato de saida. Não assuma que todo modelo 3D suporta ambos os tipos de entrada ou todos os formatos de saída. Verifique o detalhe do modelo selecionado antes de enviar image, image_url, format, quality, style ou seed.

​
Crie Uma Tarefa 3D

Para imagem-para-3D, use um image_url público sempre que possível. Use image inline/base64 apenas quando seu cliente enviar intencionalmente mídia privada e seu backend estiver preparado para corpos de solicitação maiores.

​
Opções De Formato De Saída

  • glb é geralmente o padrão mais seguro para pré-visualizações na web.
  • fbx e obj são úteis para pipelines DCC quando o modelo selecionado os suporta.
  • usdz é útil para fluxos de trabalho AR da Apple quando exposto pelo modelo.
  • Valores de quality mais altos podem aumentar a latência e o custo. Exponha-os como escolhas explícitas do usuário, não como padrões ocultos.
  • seed é útil para reprodutibilidade apenas quando o modelo o respeita.

​
Consulte E Armazene Ativos

Use o poll_url retornado primeiro. Se seu cliente precisar de uma rota fixa, use GET /v1/tasks/{id}.
Tarefas concluídas retornam model_url e podem incluir glb_url, fbx_url, obj_url ou usdz_url. Baixe ou armazene o ativo selecionado em seu próprio produto se os usuários precisarem de acesso repetido, histórico de versões ou downloads de longa duração.

​
Lista De Verificação De Produção

  • Persista task_id, poll_url, modelo, formato solicitado e seu próprio ID de registro de ativo.
  • Retome a consulta após a atualização da página, em vez de criar uma tarefa duplicada.
  • Valide o tamanho e a acessibilidade da imagem de origem antes de criar a tarefa.
  • Mantenha as URLs de ativos gerados fora de páginas públicas, a menos que o usuário tenha permissão para acessar o ativo.
  • Registre billing_transaction_id quando presente para reconciliação posterior.

​
Erros Comuns

​
Referência da API