Tripo3D

Introduzione allo Tripo API

Introduzione allo Tripo API

Tripo3D è una piattaforma di generazione 3D basata su AI- che fornisce conversione di testo in 3D, conversione di immagini in 3D, rigging, modifica di mesh e altre funzionalità. Con Tripo API, gli sviluppatori possono integrare la generazione di contenuti 3D di alta qualità nei propri prodotti.

Se accedi dalla Cina, visita il sito cinese: developers.tripo3d.com

Base URL

https://openapi.tripo3d.ai/v3

Autenticazione

Tutte le richieste API devono includere un API Key nell’intestazione della richiesta:

Authorization: Bearer {api_key}

È possibile creare e gestire API Keys nella Console Tripo.

Formato di risposta unificato

Risposta di successo

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

Risposta all’errore

JSON
{
  "code": 2010,
  "status": "error",
  "message": "You don't have enough credit to create this task",
  "suggestion": "Please purchase more credit",
  "request_id": "req_abc123"
}

Campi comuni

Parametro Digitare Descrizione
code intero Codice di stato. 0 indica successo e qualsiasi valore diverso da 0 indica un errore
status stringa Vale error in caso di errore
data oggetto Dati aziendali, restituiti solo in caso di successo
message stringa Descrizione dell’errore, restituita solo in caso di errore
suggestion stringa Correzione suggerita, restituita solo in caso di errore
request_id stringa Identificatore univoco della richiesta per la risoluzione dei problemi, restituito in caso di errore

Modello di attività asincrona

La maggior parte degli API di generazione utilizza uno schema di attività asincrono:

  1. Crea un’attività: invia una richiesta POST per creare un’attività e ricevere un task_id
  2. Sondaggio per risultati: utilizza GET /v3/tasks/{task_id} per interrogare lo stato dell’attività e il risultato
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": {...}}}

Stati delle attività

Stato Descrizione
queued In coda
running Correre
success Riuscito
failed Fallito
cancelled Annullato

Versione API

Versione attuale: v3

Panoramica degli endpoint

Generazione di modelli 3D

Punto finale Descrizione
POST /v3/generation/text-to-model Genera un modello 3D dal testo
POST /v3/generation/image-to-model Genera un modello 3D da un’immagine
POST /v3/generation/multiview-to-model Genera un modello 3D da immagini multivista

Generazione di immagini

Punto finale Descrizione
POST /v3/generation/text-to-image Genera un’immagine dal testo
POST /v3/generation/image-to-image Trasforma uno stile di immagine
POST /v3/generation/image-to-multiview Genera immagini multivista
POST /v3/generation/edit-multiview Modifica immagini multivista

Elaborazione del modello

Punto finale Descrizione
POST /v3/models/texture Texture un modello
POST /v3/models/convert Converti il formato del modello
POST /v3/mesh/segment Segmentazione semantica
POST /v3/mesh/complete Completamento della mesh
POST /v3/mesh/decimate Retopologia

Animazione

Punto finale Descrizione
POST /v3/animations/rig-check Verifica la compatibilità del rigging
POST /v3/animations/rig Prepara un modello
POST /v3/animations/retarget Reindirizzare un’animazione

Gestione delle attività

Punto finale Descrizione
GET /v3/tasks/{task_id} Interroga un’attività
POST /v3/tasks/list Interrogare le attività in batch

Gestione dei file

Punto finale Descrizione
POST /v3/files Carica un file

Conto

Punto finale Descrizione
GET /v3/account/balance Interroga il saldo del conto
AvantiAvvio rapido