Tripo: 3D Generation

Tripo ustvari 3D-model iz pisnega opisa objekta. Širši poteki dela pri proizvajalcu ločujejo geometrijo, teksturiranje in poznejšo obdelavo modela; dokončano mrežo preglejte z več zornih kotov in ohranite dejanske datoteke za ciljno sceno ali urejevalnik.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Tripo ustvarja 3D-modele iz opisa ali vizualne reference. Njegovi poteki ločujejo generiranje objekta od poznejših korakov, kot so teksturiranje, postavitev ogrodja in pretvorba. Najprej opredelite predvideni izdelek in operacijo, ki ga ustvari: statično mrežo za sceno, teksturiran objekt za upodabljanje ali model, ki bo deležen nadaljnje priprave v 3D-urejevalniku.

Pri opisu za pretvorbo besedila v model opišite obliko objekta in njegove pomembne dele. Majhno svetilko lahko določite s telesom, ročajem, odprtinami in razmerji; bitje s silhueto, okončinami in pozo. Navedite material ali vizualno obdelavo, kadar sta pomembna za rezultat. Opis naj bo osredotočen na sam objekt, da je mogoče ustvarjeno geometrijo oceniti glede na jasen načrt.

Pri proizvajalčevem poteku na podlagi referenc pripravite slike, ki prikazujejo obris subjekta in njegove značilne lastnosti. Več pogledov naj opisuje isti objekt z doslednimi razmerji in dodatki. Po generiranju preglejte dele, skrite v referenci, saj prepričljiv pogled od spredaj sam po sebi ne potrjuje, da hrbtna stran, spodnja stran ali povezave med komponentami ustrezajo predvidenemu načrtu.

Izbrano različico modela ohranite ob zahtevi. Generacijski vmesnik Tripo opredeljuje operacijo ločeno od nastavitve različice modela, dokumentirani primer pretvorbe besedila v model pa izbere izrecno različico. Pri primerjavi izdelkov ohranite natančno različico in parametre, da spremembe opisa objekta ne zamenjate s spremembo konfiguracije generiranja.

Geometrija in videz površine sta ločeni produkcijski odločitvi. Proizvajalčev osnovni potek razlikuje neteksturiran model od izhoda s teksturami in materiali za fizikalno osnovano upodabljanje. Izberite obliko izdelka, potrebno za naslednji korak, nato pa preglejte mrežo in morebitne spremljajoče materialne datoteke. Predogledna slika pomaga pri orientaciji, dejanski model pa je izdelek, potreben za sestavljanje scene in nadaljnje urejanje.

Dokončani objekt preglejte z več kotov. Preverite silhueto, ločenost delov, tanke elemente, odprtine in površine, kjer se komponente stikajo. Pri stiliziranem rekvizitu primerjajte razmerja z oblikovalskim opisom. Pri objektu, podobnem izdelku, preverite, katere podrobnosti predstavlja geometrija in katere se pojavijo samo v površinski obdelavi. Pred spremembo prompta ali reference opredelite lastnost, ki potrebuje popravek.

Generiranje poteka kot asinhrona naloga. Med preverjanjem stanja ohranite izvirno identiteto naloge ter hranite dokončani model, predogled in vse druge vrnjene datoteke skupaj. Dokumentirani rezultat vključuje izhodna polja, povezana z modelom, in upodobljene slike. Za naslednji produkcijski korak shranite same datoteke, namesto da se zanašate na začasno povezavo do rezultata ali predogled obravnavate kot celoten 3D-izdelek.

Model uvozite v predvideni urejevalnik ali pregledovalno okolje ter tam preglejte njegovo usmerjenost, merilo, materiale in geometrijo. Rekvizit za sceno, upodobitev od blizu in lik, pripravljen za animacijo, imajo različne potrebe po zaključni obdelavi. Za urejanje ohranite delovno kopijo, ustvarjeni izvorni model pa shranite skupaj z opisom in referencami. Kadar je potrebna druga operacija, na primer delo s teksturami ali postavitev ogrodja, jo izberite premišljeno ter nastali izdelek preglejte kot ločeno stopnjo.

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

tripo3d

Tripo /tripo3d

Začetek

Dovoljeni vhodi: Besedilo
Rezultati: model_3d · Slike

Na voljo v Ailoot · vhodi in metode

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

Vhod: text
Izhod: model_3d, image

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve tripo3d Pogoji: Uporabite izbirnik modela Ailoot.	Privzeto—
Polje`type`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Pogoji: Celoten primer uporablja text_to_model; druge vrste opravil zahtevajo svoje dokumentirane vhode.	Privzeto—
Polje`model_version`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Pogoji: Izberite izrecno dokumentirano različico; ta primer uporablja v3.0-20250812.	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Pogoji: Opišite predmet, ki ga želite ustvariti.	Privzeto—

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijamodel, type, model_version, prompt
Parameter`optional`	Specifikacija
Parameter`material_types`	Specifikacijatext
Parameter`conditions`	SpecifikacijaUporabite izbirnik modela Ailoot., Celoten primer uporablja text_to_model; druge vrste opravil zahtevajo svoje dokumentirane vhode., Izberite izrecno dokumentirano različico; ta primer uporablja v3.0-20250812., Opišite predmet, ki ga želite ustvariti.

Življenjski cikel: submit_once_poll_original

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $1.35 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · 3D

curl · ustvarite enkrat in ohranite potrdiloPreberite izvirno opraviloShranite vsako dokončano datoteko v svoji lasti

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

Prejmi in shrani rezultate

Ailoot Ultra · 3D

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

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

Ohrani vse dokončane rezultate

Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.

Ohranite celoten odgovor in glave, prvotne identifikatorje, vsak dejanski izhod in vsa polja porabe/obračuna. Shranite vsako enolično sredstvo v vaši lasti in ohranite vsako vlogo, ki kaže nanj.

Če je treba preveriti izvirni odgovor

Ohranite vrnjeni javni id opravila ali operacije in vse glave. Berite samo prvotno opravilo; unknown ali result_pending_check ne dovoljujeta novega ustvarjanja.

Polja odgovora

Polje	Vrsta
Polje`id`	Vrstastring
Polje`polling_url`	Vrstastring
Polje`provider_task_id`	Vrstastring
Polje`code`	Vrstainteger
Polje`data.task_id`	Vrstastring
Polje`data.status`	Vrstastring
Polje`data.progress`	Vrstainteger
Polje`data.output.*`	Vrstastring
Polje`data.result.*.url`	Vrstastring
Polje`data.result.*.type`	Vrstastring
Polje`data.thumbnail`	Vrstastring

Druga imena

Druga imena modelov

Ailoot Ultra tripo3d

Druga imena poti metod

Uporabite zgoraj navedene poti metod.

Povezani ID-ji za klic

tripo3d

FAQ · Tripo: 3D Generation

Kateri vhodi in rezultati so na voljo?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Katera polja uporablja zahteva?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation