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
tripo3dIntroduzione
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 |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti tripo3d Condizioni: Usa il selettore del modello Ailoot. | Predefinito— |
Campotype | Tipostring | 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— |
Campomodel_version | Tipostring | 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— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Condizioni: Descrivi l'oggetto da creare. | Predefinito— |
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, type, model_version, prompt |
Parametrooptional | Contratto |
Parametromaterial_types | Contrattotext |
Parametroconditions | 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 →
Esempi di richieste
Ailoot Ultra · 3D
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/assetsGET /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 |
|---|---|
Campoid | Tipostring |
Campopolling_url | Tipostring |
Campoprovider_task_id | Tipostring |
Campocode | Tipointeger |
Campodata.task_id | Tipostring |
Campodata.status | Tipostring |
Campodata.progress | Tipointeger |
Campodata.output.* | Tipostring |
Campodata.result.*.url | Tipostring |
Campodata.result.*.type | Tipostring |
Campodata.thumbnail | Tipostring |
Alias
Alias del modello
Ailoot Ultra tripo3d
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
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