modelli

Tripo: 3D Generation

Markdown · JSON

Tripo: 3D Generation

Tripo crea un modello 3D a partire da una descrizione scritta dell’oggetto. I processi più ampi del produttore distinguono geometria, texturing ed elaborazione successiva del modello; esaminate la mesh completata da più punti di vista e conservate i file effettivi per la scena o l’editor di destinazione.

Informazioni sul modello

Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.

Tripo crea modelli 3D a partire da una descrizione o da un riferimento visivo. I suoi processi separano la generazione di un oggetto dalle fasi successive, come texturing, rigging e conversione. Iniziate identificando la risorsa desiderata e l’operazione che la produce: una mesh statica per una scena, un oggetto con texture per il rendering o un modello che riceverà un’ulteriore preparazione in un editor 3D.

Per una descrizione destinata a generare un modello da testo, descrivete la forma dell’oggetto e le sue parti importanti. Una piccola lanterna può essere specificata attraverso corpo, manico, aperture e proporzioni; una creatura attraverso sagoma, arti e posa. Indicate il materiale o il trattamento visivo quando influiscono sul risultato. Mantenete la descrizione concentrata sull’oggetto stesso, affinché la geometria generata possa essere valutata rispetto a un progetto chiaro.

Per un processo del produttore basato su riferimenti, preparate immagini che mostrino il contorno del soggetto e le caratteristiche distintive. Le diverse viste devono descrivere lo stesso oggetto con proporzioni e accessori coerenti. Esaminate le parti nascoste nel riferimento dopo la generazione: una vista frontale convincente non dimostra che il retro, la parte inferiore o le connessioni tra i componenti corrispondano al progetto desiderato.

Conservate la versione del modello selezionata insieme alla richiesta. L’interfaccia di generazione di Tripo identifica l’operazione separatamente dall’impostazione della versione del modello e l’esempio documentato di generazione da testo sceglie una versione esplicita. Preservate l’esatta versione e i controlli quando confrontate le risorse, affinché una modifica alla descrizione dell’oggetto non venga confusa con una modifica alla configurazione di generazione.

La geometria e l’aspetto delle superfici sono decisioni di produzione distinte. Il processo di base del produttore distingue un modello senza texture da un output con texture e materiali per rendering basato sulla fisica. Scegliete la forma della risorsa necessaria al passo successivo, poi esaminate sia la mesh sia gli eventuali file dei materiali allegati. Un’immagine di anteprima è utile per orientarsi, mentre il modello effettivo è la risorsa necessaria per assemblare la scena e continuare le modifiche.

Esaminate l’oggetto completato da più angolazioni. Osservate la sagoma, la separazione delle parti, gli elementi sottili, le aperture e le superfici in cui i componenti si incontrano. Per un oggetto di scena stilizzato, confrontate le proporzioni con la descrizione progettuale. Per un oggetto simile a un prodotto, verificate quali dettagli siano rappresentati dalla geometria e quali compaiano soltanto nel trattamento delle superfici. Identificate la caratteristica da rivedere prima di cambiare il prompt o il riferimento.

La generazione avviene come attività asincrona. Conservate l’identificatore dell’attività originale durante i controlli di stato e mantenete insieme il modello completato, l’anteprima e gli eventuali altri file restituiti. Il risultato documentato comprende campi di output relativi al modello e immagini renderizzate. Salvate i file stessi per la fase di produzione successiva, anziché basarvi su un collegamento temporaneo al risultato o trattare l’anteprima come la risorsa 3D completa da consegnare.

Importate il modello nell’editor o nell’ambiente di visualizzazione previsto ed esaminatene orientamento, scala, materiali e geometria. Un oggetto di scena, un rendering ravvicinato e un personaggio pronto per l’animazione hanno esigenze di rifinitura diverse. Conservate una copia di lavoro per le modifiche e mantenete la risorsa sorgente generata con la relativa descrizione e i riferimenti. Quando serve un’altra operazione, come un lavoro sulle texture o il rigging, sceglietela intenzionalmente e verificate la risorsa risultante come fase separata.

Ailoot Ultra · 3D POST /v1/3d/generations tripo3d

tripo3d

Tripo /tripo3d

Introduzione

Tripo crea un modello 3D a partire da una descrizione scritta dell’oggetto. I processi più ampi del produttore distinguono geometria, texturing ed elaborazione successiva del modello; esaminate la mesh completata da più punti di vista e conservate i file effettivi per la scena o l’editor di destinazione.

Input accettati
Testo
Risultati
model_3d · Immagini

Disponibile in Ailoot · input e metodi

Ailoot Ultra · 3D POST /v1/3d/generations
Tipi di input
text
Tipi di output
model_3d, image
CampoTipoRequisitoValori e limitiPredefinito
CampomodelTipostringRequisitoObbligatorioValori e limiti
tripo3d
Condizioni: Usa il selettore del modello Ailoot.
Predefinito—
CampotypeTipostringRequisitoObbligatorioValori e limiti
text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model
Condizioni: L'esempio completo usa text_to_model; gli altri tipi di attività richiedono gli input specifici documentati per ciascuna attività.
Predefinito—
Campomodel_versionTipostringRequisitoObbligatorioValori e limiti
v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506
Condizioni: Seleziona una versione esplicitamente documentata; questo esempio usa v3.0-20250812.
Predefinito—
CampopromptTipostringRequisitoObbligatorioValori e limiti
Condizioni: Descrivi l'oggetto da creare.
Predefinito—
Parametri e ciclo di vita del metodo
ParametroContratto
Parametrocontent_typeContrattoapplication/json
ParametrorequiredContrattomodel, type, model_version, prompt
ParametrooptionalContratto
Parametromaterial_typesContrattotext
ParametroconditionsContrattoUsa il selettore del modello Ailoot., L'esempio completo usa text_to_model; gli altri tipi di attività richiedono gli input specifici documentati per ciascuna attività., Seleziona una versione esplicitamente documentata; questo esempio usa v3.0-20250812., Descrivi l'oggetto da creare.

Ciclo di vita: submit_once_poll_original

GET /v1/3d/generations/{request_id}

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tariffe

Calcolo del costo finale

Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.

Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.

Modalità rapida
Non specificato Quando è selezionata la modalità rapida
Modalità flex
Non specificato Quando è selezionata la modalità flex
Sforzo massimo di ragionamento
Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)

Tariffe stimate per il confronto

Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

ConfigurazioneListino delle tariffeQuantità previstaCosto
ConfigurazioneTariffe base dei tokenListino delle tariffeTariffa baseQuantità prevista—Costo
Input · Token in input · Stima solo a fini di confronto — / 1K token
Output · Token in output · Stima solo a fini di confronto — / 1K token
Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token
Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token
Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token
ConfigurazioneCosto stimato della generazioneListino delle tariffe—Quantità previstastima per una generazioneCosto
Output · Costo di generazione stimato · Stima solo a fini di confronto $1.35 stima prima della generazione

Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata.

Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →

Esempi di richieste

Ailoot Ultra · 3D

curl · crea una sola volta e conserva la ricevutaLeggi il task originaleSalva ogni risorsa completata di tua proprietà
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "tripo3d",
  "type": "text_to_model",
  "prompt": "a cute pig",
  "model_version": "v3.0-20250812"
}
JSON
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/3d/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

Ricevi e salva i risultati

Ailoot Ultra · 3D

Scarica ogni immagine restituita o salvane il contenuto Base64

  • GET /v1/3d/generations/{request_id}
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Conserva tutti i risultati completati

Conserva ogni risposta, file e parte di contenuto restituiti per intero.

Conserva la risposta completa e le intestazioni, gli identificatori originali, ogni risultato effettivo e tutti i campi di utilizzo e contabilizzazione. Salva ogni risorsa univoca di tua proprietà e conserva ogni ruolo che vi fa riferimento.

Se occorre verificare la risposta originale

Conserva l'id pubblico dell'attività o dell'operazione restituito e tutte le intestazioni. Consulta solo l'attività originale; unknown o result_pending_check non autorizza un'altra creazione.

Campi della risposta
CampoTipo
CampoidTipostring
Campopolling_urlTipostring
Campoprovider_task_idTipostring
CampocodeTipointeger
Campodata.task_idTipostring
Campodata.statusTipostring
Campodata.progressTipointeger
Campodata.output.*Tipostring
Campodata.result.*.urlTipostring
Campodata.result.*.typeTipostring
Campodata.thumbnailTipostring

Alias

Alias del modello

Ailoot Ultra tripo3d

Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

ID di chiamata correlati

tripo3d

FAQ · Tripo: 3D Generation
Quali input e risultati sono disponibili?

POST /v1/3d/generations · tripo3d: text → model_3d, image

Quali campi usa la richiesta?

POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Maggiori dettagli

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento
Scegli un piano scontato per richieste regolari.
Codice fino al 50%
Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.
Spese nella cronologia
Modello, token e importo sono salvati per ogni richiesta.

Scegli abbonamento · Consulta prezzi dei modelli

Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale
Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.
Licenza reseller
Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.
Documenti sul sito
Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

Richiedi licenza reseller · Offerta e accordo di licenza