Source: https://ailoot.ai/models/it/tripo3d/ Canonical: https://ailoot.ai/models/it/tripo3d/ Language: it # Tripo: 3D Generation [Markdown](https://ailoot.ai/models/it/tripo3d/index.md) · [JSON](https://ailoot.ai/models/it/tripo3d/facts.json) ## [Tripo: 3D Generation](https://ailoot.ai/models/it/tripo3d/) 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. - [**Ailoot Ultra · 3D** `POST /v1/3d/generations` `tripo3d`](https://ailoot.ai/models/it/tripo3d/#method-0) 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`](https://ailoot.ai/models/it/#m=tripo3d&route=Ultra&caller=tripo3d&fmt=3d) 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` | Campo | Tipo | Requisito | Valori e limiti | Predefinito | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti tripo3d Condizioni: Usa il selettore del modello Ailoot. | Predefinito— | | Campo`type` | Tipo`string` | RequisitoObbligatorio | Valori 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— | | Campo`model_version` | Tipo`string` | RequisitoObbligatorio | Valori 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— | | Campo`prompt` | Tipo`string` | RequisitoObbligatorio | Valori e limiti Condizioni: Descrivi l'oggetto da creare. | Predefinito— | Parametri e ciclo di vita del metodo | Parametro | Contratto | | --- | --- | | Parametro`content_type` | Contrattoapplication/json | | Parametro`required` | Contrattomodel, type, model\_version, prompt | | Parametro`optional` | Contratto | | Parametro`material_types` | Contrattotext | | Parametro`conditions` | ContrattoUsa 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. | Configurazione | Listino delle tariffe | Quantità prevista | Costo | | --- | --- | --- | --- | | ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità 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 generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Costo 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 →](https://ailoot.ai/docs/it/billing/reserve/) ### Esempi di richieste #### Ailoot Ultra · 3D curl · crea una sola volta e conserva la ricevutaLeggi il task originaleSalva ogni risorsa completata di tua proprietà ```bash 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. ``` ```bash 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 ``` ```bash 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 | Campo | Tipo | | --- | --- | | Campo`id` | Tipostring | | Campo`polling_url` | Tipostring | | Campo`provider_task_id` | Tipostring | | Campo`code` | Tipointeger | | Campo`data.task_id` | Tipostring | | Campo`data.status` | Tipostring | | Campo`data.progress` | Tipointeger | | Campo`data.output.*` | Tipostring | | Campo`data.result.*.url` | Tipostring | | Campo`data.result.*.type` | Tipostring | | Campo`data.thumbnail` | Tipostring | ### Alias #### Alias del modello **Ailoot Ultra** [`tripo3d`](https://ailoot.ai/models/it/#m=tripo3d&route=Ultra&caller=tripo3d&fmt=3d) #### Alias dei percorsi dei metodi Usa i percorsi dei metodi indicati sopra. #### ID di chiamata correlati [`tripo3d`](https://ailoot.ai/models/it/#m=tripo3d&route=Ultra&caller=tripo3d&fmt=3d) 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` 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](https://ailoot.ai/docs/it/billing/subscriptions/) · [Consulta prezzi dei modelli](https://ailoot.ai/models/it/) ## 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](mailto:support@ailoot.ai) · [Offerta e accordo di licenza](https://ailoot.ai/legal/offer?lang=it) ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.