Tripo: 3D Generation

Tripo vytvára 3D model podľa písomného zadania objektu. Širšie postupy výrobcu rozlišujú geometriu, textúrovanie a neskoršie spracovanie modelu; hotovú sieť preskúmajte z viacerých pohľadov a skutočné súbory uchovajte pre cieľovú scénu alebo editor.

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

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

Tripo vytvára 3D modely podľa opisu alebo vizuálnej referencie. Jeho postupy oddeľujú vytvorenie objektu od neskorších krokov, ako sú textúrovanie, tvorba kostry a konverzia. Začnite určením zamýšľaného výstupu a operácie, ktorá ho vytvára: statická sieť pre scénu, textúrovaný objekt na renderovanie alebo model, ktorý sa bude ďalej pripravovať v 3D editore.

V zadaní na vytvorenie modelu z textu opíšte tvar objektu a jeho dôležité časti. Malý lampáš možno určiť jeho telom, rukoväťou, otvormi a proporciami; tvora jeho siluetou, končatinami a pózou. Uveďte materiál alebo vizuálne spracovanie, keď sú pre výsledok dôležité. Opis zamerajte na samotný objekt, aby sa vytvorená geometria dala posúdiť podľa jasného návrhu.

Pri postupe výrobcu založenom na referenciách pripravte obrázky zobrazujúce obrys objektu a jeho rozlišujúce znaky. Viaceré pohľady majú opisovať rovnaký objekt s konzistentnými proporciami a doplnkami. Po vygenerovaní skontrolujte časti skryté v referencii, pretože presvedčivý pohľad spredu nedokazuje, že zadná strana, spodná strana alebo spojenia komponentov zodpovedajú zamýšľanému návrhu.

Vybranú verziu modelu uchovajte spolu s požiadavkou. Generačné rozhranie Tripo identifikuje operáciu oddelene od nastavenia verzie modelu a zdokumentovaný príklad vytvorenia modelu z textu volí výslovnú verziu. Pri porovnávaní výstupov zachovajte presnú verziu a ovládacie prvky, aby sa zmena opisu objektu nezamenila so zmenou konfigurácie generovania.

Geometria a vzhľad povrchu sú samostatné výrobné rozhodnutia. Základný postup výrobcu odlišuje model bez textúr od výstupu s textúrami a materiálmi pre fyzikálne založené renderovanie. Vyberte podobu výstupu potrebnú pre ďalší krok a potom preskúmajte sieť aj sprievodné súbory materiálov. Náhľadový obrázok je užitočný na orientáciu, zatiaľ čo skutočný model je výstupom potrebným na zostavenie scény a ďalšie úpravy.

Hotový objekt preskúmajte z viacerých uhlov. Pozrite sa na siluetu, oddelenie častí, tenké prvky, otvory a povrchy, na ktorých sa stretávajú komponenty. Pri štylizovanej rekvizite porovnajte proporcie s návrhovým zadaním. Pri objekte podobnom produktu skontrolujte, ktoré detaily predstavuje geometria a ktoré sa objavujú iba v úprave povrchu. Pred zmenou promptu alebo referencie určte prvok, ktorý treba upraviť.

Generovanie prebieha ako asynchrónna úloha. Pôvodnú identitu úlohy zachovajte počas kontrol stavu a hotový model, náhľad a všetky ostatné vrátené súbory uchovajte spolu. Zdokumentovaný výsledok zahŕňa výstupné polia súvisiace s modelom a renderované obrázky. Pre ďalší výrobný krok uložte samotné súbory namiesto spoliehania sa na dočasný odkaz na výsledok alebo považovania náhľadu za úplný 3D výstup.

Model importujte do zamýšľaného editora alebo zobrazovacieho prostredia a tam preskúmajte jeho orientáciu, mierku, materiály a geometriu. Rekvizita scény, detailný render a postava pripravená na animáciu majú odlišné potreby dokončenia. Pracovnú kópiu uchovajte na úpravy a vytvorený zdrojový model zachovajte so zadaním a referenciami. Keď treba ďalšiu operáciu, napríklad prácu s textúrami alebo tvorbu kostry, zvoľte ju zámerne a výsledný výstup preskúmajte ako samostatnú fázu.

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

tripo3d

Tripo /tripo3d

Úvod

Povolené vstupy: Text
Výsledky: model_3d · Obrázky

Dostupné v Ailoot · vstupy a metódy

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

Vstup: text
Výstup: model_3d, image

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity tripo3d Podmienky: Použite volič modelu Ailoot.	Predvolené—
Pole`type`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Podmienky: Úplný príklad používa text_to_model; ostatné typy úloh vyžadujú svoje zdokumentované vstupy špecifické pre danú úlohu.	Predvolené—
Pole`model_version`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Podmienky: Vyberte výslovne zdokumentovanú verziu; tento príklad používa v3.0-20250812.	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Podmienky: Opíšte objekt, ktorý sa má vytvoriť.	Predvolené—

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, type, model_version, prompt
Parameter`optional`	Špecifikácia
Parameter`material_types`	Špecifikáciatext
Parameter`conditions`	ŠpecifikáciaPoužite volič modelu Ailoot., Úplný príklad používa text_to_model; ostatné typy úloh vyžadujú svoje zdokumentované vstupy špecifické pre danú úlohu., Vyberte výslovne zdokumentovanú verziu; tento príklad používa v3.0-20250812., Opíšte objekt, ktorý sa má vytvoriť.

Životný cyklus: submit_once_poll_original

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $1.35 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · 3D

curl · vytvoriť iba raz a uchovať potvrdeniePrečítať pôvodnú úlohuUložiť každý hotový výstup, ktorý vám patrí

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

Prijať a uložiť výsledky

Ailoot Ultra · 3D

Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64

GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Uchovať všetky dokončené výsledky

Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.

Zachovajte celú odpoveď a hlavičky, pôvodné identifikátory, každý skutočný výstup a všetky polia spotreby a účtovania. Uložte každý jedinečný súbor vo vašom vlastníctve a zachovajte každú rolu, ktorá naň odkazuje.

Ak treba overiť pôvodnú odpoveď

Zachovajte vrátené verejné id úlohy alebo operácie a všetky hlavičky. Načítavajte iba pôvodnú úlohu; unknown ani result_pending_check neoprávňujú na ďalšie vytvorenie.

Polia odpovede

Pole	Typ
Pole`id`	Typstring
Pole`polling_url`	Typstring
Pole`provider_task_id`	Typstring
Pole`code`	Typinteger
Pole`data.task_id`	Typstring
Pole`data.status`	Typstring
Pole`data.progress`	Typinteger
Pole`data.output.*`	Typstring
Pole`data.result.*.url`	Typstring
Pole`data.result.*.type`	Typstring
Pole`data.thumbnail`	Typstring

Aliasy

Aliasy modelov

Ailoot Ultra tripo3d

Aliasy ciest metód

Použite cesty metód uvedené vyššie.

Súvisiace ID na volanie

tripo3d

FAQ · Tripo: 3D Generation

Aké vstupy a výsledky sú dostupné?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Aké polia používa požiadavka?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation