Tripo: 3D Generation
A Tripo írásos tárgyleírásból készít 3D-modellt. A gyártó tágabb munkafolyamatai külön kezelik a geometriát, a textúrázást és a modell későbbi feldolgozását; a kész hálót több nézőpontból vizsgáld meg, és a céljelenethez vagy szerkesztőhöz őrizd meg a tényleges fájlokat.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A Tripo leírásból vagy vizuális referenciából készít 3D-modelleket. Munkafolyamatai elkülönítik a tárgy létrehozását a későbbi lépésektől, például a textúrázástól, a riggeléstől és az átalakítástól. Először azonosítsd a kívánt elemet és az azt előállító műveletet: statikus hálót egy jelenethez, textúrázott tárgyat rendereléshez vagy olyan modellt, amelyet tovább készítenek elő egy 3D-szerkesztőben.
Szövegből modellt létrehozó leírásban mutasd be a tárgy alakját és fontos részeit. Egy kis lámpást a testével, fogantyújával, nyílásaival és arányaival határozhatsz meg; egy lényt a sziluettjével, végtagjaival és pózával. Add meg az anyagot vagy a vizuális kidolgozást, ha számít az eredmény szempontjából. A leírás magára a tárgyra összpontosítson, hogy a generált geometria egyértelmű tervhez mérten legyen értékelhető.
A gyártó referenciaalapú munkafolyamatához olyan képeket készíts elő, amelyek megmutatják a téma körvonalát és megkülönböztető jegyeit. A több nézetnek ugyanazt a tárgyat kell ábrázolnia következetes arányokkal és kiegészítőkkel. Generálás után vizsgáld meg a referencián takart részeket, mert a meggyőző elölnézet nem bizonyítja, hogy a hátoldal, az alsó rész vagy az elemek csatlakozásai megfelelnek a kívánt tervnek.
A kiválasztott modellverziót tartsd a kérés mellett. A Tripo generálási felülete a műveletet a modellverzió beállításától külön azonosítja, és a dokumentált szövegből modellt létrehozó példa kifejezett verziót választ. Az elemek összehasonlításakor őrizd meg a pontos verziót és vezérlőbeállításokat, hogy a tárgyleírás változása ne keveredjen a generálási konfiguráció változásával.
A geometria és a felületi megjelenés külön gyártási döntés. A gyártó alapmunkafolyamata megkülönbözteti a textúra nélküli modellt a textúrákkal és fizikai alapú rendereléshez készült anyagokkal rendelkező kimenettől. Válaszd a következő lépéshez szükséges elemformát, majd vizsgáld meg a hálót és az esetleges kísérő anyagfájlokat is. Az előnézeti kép segít a tájékozódásban, a jelenet összeállításához és a további szerkesztéshez viszont a tényleges modell szükséges.
A kész tárgyat több szögből vizsgáld meg. Nézd meg a sziluettet, a részek elkülönülését, a vékony elemeket, a nyílásokat és az alkotórészek találkozási felületeit. Stilizált kelléknél hasonlítsd össze az arányokat a tervezési leírással. Termékszerű tárgynál ellenőrizd, mely részleteket ábrázolja a geometria, és melyek jelennek meg csak a felületi kidolgozásban. A prompt vagy referencia módosítása előtt azonosítsd a javítandó jellemzőt.
A generálás aszinkron feladatként fut. Az állapotellenőrzés során őrizd meg az eredeti feladat azonosítóját, és tartsd együtt a kész modellt, az előnézetet és a többi visszaadott fájlt. A dokumentált eredmény modellhez kapcsolódó kimeneti mezőket és renderelt képeket tartalmaz. A következő gyártási lépéshez magukat a fájlokat mentsd el, ahelyett, hogy ideiglenes eredményhivatkozásra támaszkodnál, vagy az előnézetet a teljes 3D-átadandó anyagnak tekintenéd.
Importáld a modellt a tervezett szerkesztőbe vagy megjelenítési környezetbe, és ott ellenőrizd a tájolását, méretarányát, anyagait és geometriáját. Egy jelenetkellék, egy közeli render és egy animálásra kész karakter eltérő utómunkát igényel. A szerkesztéshez tarts munkapéldányt, és őrizd meg a generált forráselemet a leírásával és referenciáival együtt. Ha másik műveletre, például textúramunkára vagy riggelésre van szükség, tudatosan válaszd ki azt, és az eredményül kapott elemet külön szakaszként ellenőrizd.
Ailoot Ultra · 3D POST /v1/3d/generations tripo3d
tripo3dKezdő lépések
A Tripo írásos tárgyleírásból készít 3D-modellt. A gyártó tágabb munkafolyamatai külön kezelik a geometriát, a textúrázást és a modell későbbi feldolgozását; a kész hálót több nézőpontból vizsgáld meg, és a céljelenethez vagy szerkesztőhöz őrizd meg a tényleges fájlokat.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- model_3d · Képek
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · 3D POST /v1/3d/generations
- Bemenet
text- Kimenet
model_3d,image
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok tripo3d Feltételek: Használja az Ailoot modellválasztóját. | Alapértelmezett— |
Mezőtype | Típusstring | KövetelményKötelező | Értékek és korlátok text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Feltételek: A teljes példa text_to_model értéket használ; a többi feladattípushoz a dokumentált, feladatspecifikus bemenetek szükségesek. | Alapértelmezett— |
Mezőmodel_version | Típusstring | KövetelményKötelező | Értékek és korlátok v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Feltételek: Válasszon kifejezetten dokumentált verziót; ez a példa a v3.0-20250812 verziót használja. | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Feltételek: Írja le a létrehozandó objektumot. | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, type, model_version, prompt |
Paraméteroptional | Szerződés |
Paramétermaterial_types | Szerződéstext |
Paraméterconditions | SzerződésHasználja az Ailoot modellválasztóját., A teljes példa text_to_model értéket használ; a többi feladattípushoz a dokumentált, feladatspecifikus bemenetek szükségesek., Válasszon kifejezetten dokumentált verziót; ez a példa a v3.0-20250812 verziót használja., Írja le a létrehozandó objektumot. |
Életciklus: submit_once_poll_original
GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $1.35 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
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
Eredmények fogadása és mentése
Ailoot Ultra · 3D
Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/3d/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Őrizze meg a teljes választ és fejléceit, az eredeti azonosítókat, az összes tényleges kimenetet és minden felhasználási, illetve elszámolási mezőt. Mentsen el minden egyedi saját médiaállományt, és őrizzen meg minden rá mutató szerepet.
Ha az eredeti választ ellenőrizni kell
Őrizze meg a visszaadott nyilvános feladat- vagy műveletazonosítót és az összes fejlécet. Csak az eredeti feladatot kérdezze le; az unknown vagy result_pending_check nem jogosít fel újabb létrehozásra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőpolling_url | Típusstring |
Mezőprovider_task_id | Típusstring |
Mezőcode | Típusinteger |
Meződata.task_id | Típusstring |
Meződata.status | Típusstring |
Meződata.progress | Típusinteger |
Meződata.output.* | Típusstring |
Meződata.result.*.url | Típusstring |
Meződata.result.*.type | Típusstring |
Meződata.thumbnail | Típusstring |
Álnevek
Modell álnevei
Ailoot Ultra tripo3d
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Tripo: 3D Generation
- Milyen bemenetek és eredmények érhetők el?
POST /v1/3d/generations·tripo3d:text→model_3d,image- Mely mezőket használja a kérés?
POST /v1/3d/generations·tripo3d:model,type,model_version,prompt