Tripo: 3D Generation

Tripo sukuria 3D modelio failą pagal rašytinį objekto aprašymą. Platesnės gamintojo darbo eigos atskiria geometriją, tekstūravimą ir vėlesnį modelio apdorojimą; patikrinkite užbaigtą tinklą iš kelių pusių ir išsaugokite tikrus failus numatytai scenai ar redaktoriui.

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

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Tripo kuria 3D modelių failus pagal aprašymą arba vaizdinę nuorodą. Jo darbo eigos atskiria objekto generavimą nuo vėlesnių etapų, tokių kaip tekstūravimas, skeleto parengimas ir konvertavimas. Pirmiausia nustatykite numatytą rezultatą ir jį kuriančią operaciją: statinį tinklą scenai, tekstūruotą objektą vaizdui atvaizduoti arba modelį, kuris bus toliau ruošiamas 3D redaktoriuje.

Teksto pavertimo modeliu užduotyje aprašykite objekto formą ir svarbias dalis. Nedidelį žibintą galima nusakyti jo korpusu, rankena, angomis ir proporcijomis, o padarą — siluetu, galūnėmis ir poza. Jei rezultatui svarbi medžiaga ar vaizdinis stilius, juos nurodykite. Aprašyme sutelkite dėmesį į patį objektą, kad sugeneruotą geometriją būtų galima įvertinti pagal aiškų sumanymą.

Gamintojo vaizdais grindžiamai darbo eigai paruoškite nuotraukas ar iliustracijas, rodančias objekto kontūrą ir išskirtines savybes. Keli vaizdai turėtų rodyti tą patį objektą su nuosekliomis proporcijomis ir priedais. Po generavimo patikrinkite nuorodose nematomas dalis, nes įtikinamas vaizdas iš priekio nepatvirtina, kad nugarinė pusė, apačia ar dalių jungtys atitinka numatytą dizainą.

Pasirinktą modelio versiją išsaugokite kartu su užklausa. Tripo generavimo sąsaja operaciją nurodo atskirai nuo modelio versijos parametro, o dokumentuotame teksto pavertimo modeliu pavyzdyje pasirenkama konkreti versija. Lygindami rezultatus išsaugokite tikslią versiją ir parametrus, kad objekto aprašymo pakeitimas nebūtų supainiotas su generavimo konfigūracijos pakeitimu.

Geometrija ir paviršiaus išvaizda yra atskiri kūrimo sprendimai. Gamintojo pagrindinė darbo eiga atskiria modelį be tekstūrų nuo rezultato su tekstūromis ir fizika pagrįsto atvaizdavimo medžiagomis. Pasirinkite kitam etapui reikalingą modelio pavidalą, tada patikrinkite ir tinklą, ir visus pridedamus medžiagų failus. Peržiūros vaizdas padeda susiorientuoti, o scenos surinkimui ir tolesniam redagavimui reikia tikro modelio failo.

Užbaigtą objektą apžiūrėkite iš kelių kampų. Patikrinkite siluetą, dalių atskyrimą, plonas detales, angas ir komponentų susijungimo paviršius. Stilizuoto rekvizito proporcijas palyginkite su užduoties aprašymu. Į gaminį panašaus objekto atveju nustatykite, kurios detalės suformuotos geometrija, o kurios matomos tik paviršiaus apdailoje. Prieš keisdami promptą ar vaizdinę nuorodą įvardykite savybę, kurią reikia pataisyti.

Generavimas vyksta kaip asinchroninė užduotis. Tikrindami būseną išsaugokite pradinį užduoties identifikatorių, o užbaigtą modelį, peržiūros vaizdą ir visus kitus grąžintus failus laikykite kartu. Dokumentuotame rezultate yra su modeliu susijusių išvesties laukų ir atvaizduotų vaizdų. Kitam kūrimo etapui išsaugokite pačius failus, užuot pasikliovę laikina rezultato nuoroda ar laikę peržiūros vaizdą visu 3D rezultatu.

Importuokite modelį į numatytą redaktorių arba peržiūros aplinką ir ten patikrinkite jo orientaciją, mastelį, medžiagas bei geometriją. Scenos rekvizitas, vaizdas iš arti ir animacijai parengtas veikėjas turi skirtingus baigiamojo paruošimo poreikius. Redagavimui palikite darbinę kopiją ir išsaugokite sugeneruotą pradinį modelį kartu su užduoties aprašymu bei nuorodomis. Jei reikia kitos operacijos, pavyzdžiui, tekstūravimo ar skeleto parengimo, pasirinkite ją tikslingai ir gautą rezultatą vertinkite kaip atskirą etapą.

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

tripo3d

Tripo /tripo3d

Pradžia

Leidžiamos įvestys: Tekstas
Rezultatai: model_3d · Vaizdai

Prieinama Ailoot · įvestys ir metodai

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

Įvestis: text
Išvestis: model_3d, image

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos tripo3d Sąlygos: Naudokite Ailoot modelio parinkiklį.	Numatyta—
Laukas`type`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Sąlygos: Visame pavyzdyje naudojama text_to_model; kitų tipų užduotims reikia jų dokumentacijoje nurodytų konkrečios užduoties įvesties duomenų.	Numatyta—
Laukas`model_version`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Sąlygos: Pasirinkite dokumentacijoje aiškiai nurodytą versiją; šiame pavyzdyje naudojama v3.0-20250812.	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Sąlygos: Aprašykite kuriamą objektą.	Numatyta—

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, type, model_version, prompt
Parametras`optional`	Specifikacija
Parametras`material_types`	Specifikacijatext
Parametras`conditions`	SpecifikacijaNaudokite Ailoot modelio parinkiklį., Visame pavyzdyje naudojama text_to_model; kitų tipų užduotims reikia jų dokumentacijoje nurodytų konkrečios užduoties įvesties duomenų., Pasirinkite dokumentacijoje aiškiai nurodytą versiją; šiame pavyzdyje naudojama v3.0-20250812., Aprašykite kuriamą objektą.

Gyvavimo ciklas: submit_once_poll_original

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $1.35 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · 3D

curl · sukurkite vieną kartą ir išsaugokite gavimo patvirtinimąPeržiūrėkite pirminę užduotįIšsaugokite kiekvieną užbaigtą jums priklausantį išteklių

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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · 3D

Atsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį

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

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną visą grąžintą atsakymą, failą ir turinio dalį.

Išsaugokite visą atsakymą ir antraštes, pradinius identifikatorius, kiekvieną tikrą rezultatą ir visus naudojimo bei apskaitos laukus. Išsaugokite kiekvieną unikalų jums priklausantį išteklių ir visas į jį nukreiptas paskirtis.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą viešą užduoties ar operacijos id ir visas antraštes. Skaitykite tik pradinės užduoties duomenis; unknown arba result_pending_check nesuteikia leidimo kurti dar kartą.

Atsakymo laukai

Laukas	Tipas
Laukas`id`	Tipasstring
Laukas`polling_url`	Tipasstring
Laukas`provider_task_id`	Tipasstring
Laukas`code`	Tipasinteger
Laukas`data.task_id`	Tipasstring
Laukas`data.status`	Tipasstring
Laukas`data.progress`	Tipasinteger
Laukas`data.output.*`	Tipasstring
Laukas`data.result.*.url`	Tipasstring
Laukas`data.result.*.type`	Tipasstring
Laukas`data.thumbnail`	Tipasstring

Pseudonimai

Modelių pseudonimai

Ailoot Ultra tripo3d

Metodų kelių pseudonimai

Naudokite aukščiau nurodytus metodų kelius.

Susiję ID iškvietimui

tripo3d

FAQ · Tripo: 3D Generation

Kokios įvestys ir rezultatai prieinami?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Kokius laukus naudoja užklausa?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation