Tripo: 3D Generation

Tripo vytváří 3D model podle písemného zadání objektu. Širší postupy výrobce rozlišují geometrii, texturování a pozdější zpracování modelu; prohlédněte dokončenou síť z několika pohledů a uchovejte skutečné soubory pro cílovou scénu nebo editor.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Tripo vytváří 3D modelové podklady z popisu nebo vizuální reference. Jeho postupy oddělují generování objektu od pozdějších kroků, jako jsou texturování, rigging a konverze. Začněte určením zamýšleného podkladu a operace, která jej vytváří: statické sítě pro scénu, texturovaného objektu pro renderování nebo modelu určeného k dalším přípravám ve 3D editoru.

U textového zadání pro model popište tvar objektu a jeho důležité části. Malou lucernu lze specifikovat pomocí těla, držadla, otvorů a proporcí; tvora pomocí siluety, končetin a pózy. Pokud je to pro výsledek důležité, určete materiál nebo vizuální zpracování. Popis zaměřte na samotný objekt, aby bylo možné vytvořenou geometrii posoudit vůči jasnému návrhu.

Pro postup výrobce založený na referencích připravte obrázky ukazující obrys objektu a rozlišující znaky. Několik pohledů má popisovat tentýž objekt s konzistentními proporcemi a doplňky. Po generování zkontrolujte části skryté v referenci, protože přesvědčivý čelní pohled nepotvrzuje, že zadní strana, spodní strana nebo spoje komponent odpovídají zamýšlenému návrhu.

Uchovejte vybranou verzi modelu s požadavkem. Generovací rozhraní Tripo identifikuje operaci odděleně od nastavení verze modelu a dokumentovaný příklad tvorby modelu z textu vybírá výslovnou verzi. Při porovnávání podkladů zachovejte přesnou verzi a ovládací prvky, aby se změna popisu objektu nezaměnila se změnou konfigurace generování.

Geometrie a vzhled povrchu jsou samostatná produkční rozhodnutí. Základní postup výrobce rozlišuje netexturovaný model od výstupu s texturami a materiály pro fyzikálně založené renderování. Vyberte podobu podkladu potřebnou pro další krok a poté zkontrolujte síť i doprovodné soubory materiálů. Náhledový obrázek je užitečný pro orientaci, zatímco skutečný model je podkladem potřebným pro sestavení scény a další úpravy.

Prohlédněte dokončený objekt z několika úhlů. Sledujte siluetu, oddělení částí, tenké prvky, otvory a povrchy, kde se komponenty setkávají. U stylizované rekvizity porovnejte proporce s návrhovým zadáním. U objektu připomínajícího produkt zkontrolujte, které detaily představuje geometrie a které se objevují pouze v povrchovém zpracování. Před změnou promptu nebo reference určete prvek vyžadující revizi.

Generování běží jako asynchronní úloha. Identitu původní úlohy zachovejte při kontrole stavu a ponechte dokončený model, náhled i všechny další vrácené soubory společně. Dokumentovaný výsledek obsahuje výstupní pole související s modelem a renderované snímky. Uložte samotné soubory pro další produkční krok, místo spoléhání na dočasný výsledkový odkaz nebo považování náhledu za úplný 3D výstup.

Importujte model do zamýšleného editoru nebo prohlížecího prostředí a tam zkontrolujte jeho orientaci, měřítko, materiály a geometrii. Rekvizita scény, detailní render a postava připravená k animaci mají různé potřeby dokončení. Ponechte pracovní kopii pro úpravy a uchovejte vytvořený zdrojový podklad se zadáním a referencemi. Pokud je potřeba další operace, například práce s texturami nebo rigging, vyberte ji vědomě a posuďte výsledný podklad jako samostatnou fázi.

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

tripo3d

Tripo /tripo3d

Úvod

Přijímané vstupy: Text
Výsledky: model_3d · Obrázky

Dostupné v Ailoot · vstupy a metody

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

Vstup: text
Výstup: model_3d, image

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity tripo3d Podmínky: Použijte výběr modelu Ailoot.	Výchozí—
Pole`type`	Typ`string`	PožadavekPovinné	Hodnoty a limity text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Podmínky: Úplný příklad používá text_to_model; jiné typy úloh vyžadují dokumentované vstupy příslušného typu.	Výchozí—
Pole`model_version`	Typ`string`	PožadavekPovinné	Hodnoty a limity v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Podmínky: Vyberte výslovně dokumentovanou verzi; tento příklad používá v3.0-20250812.	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity Podmínky: Popište objekt, který chcete vytvořit.	Výchozí—

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, type, model_version, prompt
Parametr`optional`	Kontrakt
Parametr`material_types`	Kontrakttext
Parametr`conditions`	KontraktPoužijte výběr modelu Ailoot., Úplný příklad používá text_to_model; jiné typy úloh vyžadují dokumentované vstupy příslušného typu., Vyberte výslovně dokumentovanou verzi; tento příklad používá v3.0-20250812., Popište objekt, který chcete vytvořit.

Životní cyklus: submit_once_poll_original

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim: Neuvedeno Při výběru rychlého režimu
Režim flex: Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování: Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

Konfigurace	Tabulka sazeb	Předpokládané množství	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $1.35 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

Ailoot Ultra · 3D

curl · vytvořte jednou a uchovejte potvrzeníNačtěte původní úlohuUložte každý dokončený výstup, který vlastníte

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

Přijímání a ukládání výsledků

Ailoot Ultra · 3D

Stáhněte každý vrácený obrázek nebo uložte jeho obsah Base64

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

Uchovejte všechny dokončené výsledky

Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.

Uchovejte celou odpověď a hlavičky, původní identifikátory, každý skutečný výstup a všechna pole využití a účtování. Uložte každý jedinečný soubor spravovaný službou a zachovejte každou roli, která na něj odkazuje.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené veřejné id úlohy nebo operace a všechny hlavičky. Načítejte pouze původní úlohu; unknown ani result_pending_check neopravňují k dalšímu vytvoření.

Pole odpovědi

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 modelu

Ailoot Ultra tripo3d

Aliasy cest metod

Použijte cesty metod uvedené výše.

Související ID modelů

tripo3d

FAQ · Tripo: 3D Generation

Jaké vstupy a výsledky jsou dostupné?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Jaká pole požadavek používá?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation