Tripo3D

Introdução ao Tripo API

Introdução ao Tripo API

Tripo3D é uma plataforma de geração 3D com tecnologia AI- que fornece texto para 3D, imagem para 3D, rigging, edição de malha e outros recursos. Com o Tripo API, os desenvolvedores podem integrar a geração de conteúdo 3D de alta qualidade em seus próprios produtos.

Se você estiver acessando da China, visite o site da China: developers.tripo3d.com

Base URL

https://openapi.tripo3d.ai/v3

Autenticação

Todas as solicitações API devem incluir um API Key no cabeçalho da solicitação:

Authorization: Bearer {api_key}

Você pode criar e gerenciar API Keys no Console Tripo.

Formato de resposta unificada

Resposta de sucesso

JSON
{
  "code": 0,
  "data": {
    ...
  }
}

Resposta de erro

JSON
{
  "code": 2010,
  "message": "Insufficient credits",
  "suggestion": "Please top up your account"
}

Campos Comuns

Parâmetro Tipo Descrição
code inteiro Código de status. 0 indica sucesso e qualquer valor diferente de 0 indica um erro
data objeto Dados de negócios, retornados apenas em caso de sucesso
message cadeia Descrição do erro, retornada somente em caso de falha
suggestion cadeia Correção sugerida, retornada somente em caso de falha

Padrão de tarefa assíncrona

A maioria dos APIs da geração usa um padrão de tarefa assíncrona:

  1. Criar uma tarefa - Envie uma solicitação POST para criar uma tarefa e receba um task_id
  2. Pesquisa de resultados - Use GET /v3/tasks/{task_id} para consultar o status e o resultado da tarefa
POST /v3/generation/text-to-model  ->  {"code": 0, "data": {"task_id": "task_abc123"}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "running", "progress": 50}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "success", "output": {...}}}

Status de tarefas

Estado Descrição
queued Na fila
running Correndo
success Sucesso
failed Falha
cancelled Cancelado

Versão API

Versão atual: v3

Visão geral do terminal

Geração de modelo 3D

Ponto final Descrição
POST /v3/generation/text-to-model Gere um modelo 3D a partir de texto
POST /v3/generation/image-to-model Gere um modelo 3D a partir de uma imagem
POST /v3/generation/multiview-to-model Gere um modelo 3D a partir de imagens multivisualização

Geração de imagem

Ponto final Descrição
POST /v3/generation/text-to-image Gerar uma imagem a partir de texto
POST /v3/generation/image-to-image Transforme um estilo de imagem
POST /v3/generation/image-to-multiview Gerar imagens multivisualização
POST /v3/generation/edit-multiview Editar imagens multivisualização

Processamento de modelo

Ponto final Descrição
POST /v3/models/texture Texturizar um modelo
POST /v3/models/convert Converter formato de modelo
POST /v3/mesh/segment Segmentação semântica
POST /v3/mesh/complete Conclusão da malha
POST /v3/mesh/decimate Retopologia

Animação

Ponto final Descrição
POST /v3/animations/rig-check Verifique a compatibilidade de rigging
POST /v3/animations/rig Montar um modelo
POST /v3/animations/retarget Redirecionar uma animação

Gerenciamento de tarefas

Ponto final Descrição
GET /v3/tasks/{task_id} Consultar uma tarefa
POST /v3/tasks/list Consultar tarefas em lote

Gerenciamento de arquivos

Ponto final Descrição
POST /v3/files Carregar um arquivo

Conta

Ponto final Descrição
GET /v3/account/balance Consultar saldo da conta