Tripo: 3D Generation

Tripo luo 3D-mallin kirjallisen kohdekuvauksen perusteella. Valmistajan laajemmat työnkulut erottavat geometrian, teksturoinnin ja mallin myöhemmän käsittelyn; tarkista valmis polygoniverkko useasta suunnasta ja säilytä varsinaiset tiedostot kohdekohtausta tai editoria varten.

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

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Tripo luo 3D-malleja kuvauksen tai visuaalisen referenssin perusteella. Sen työnkulut erottavat kohteen tuottamisen myöhemmistä vaiheista, kuten teksturoinnista, riggauksesta ja muunnoksista. Aloita määrittämällä haluttu malliaineisto ja sen tuottava toiminto: staattinen polygoniverkko kohtaukseen, teksturoitu kohde renderöintiin tai malli, jota valmistellaan edelleen 3D-editorissa.

Kuvaa tekstistä malliksi tehtävää varten kohteen muoto ja tärkeät osat. Pienen lyhdyn voi määrittää rungon, kahvan, aukkojen ja mittasuhteiden kautta; olennon siluetin, raajojen ja asennon kautta. Määritä materiaali tai visuaalinen käsittely, kun se vaikuttaa tulokseen. Keskity kuvauksessa itse kohteeseen, jotta tuotettua geometriaa voidaan arvioida selkeää suunnitelmaa vasten.

Valmistele valmistajan referenssipohjaista työnkulkua varten kuvia, jotka näyttävät kohteen ääriviivat ja tunnusomaiset piirteet. Usean näkymän tulee kuvata samaa kohdetta yhtenäisin mittasuhtein ja lisäosin. Tarkista referenssissä piiloon jäävät osat mallin tuottamisen jälkeen, koska vakuuttava etunäkymä ei osoita, että takaosa, alapuoli tai osien väliset liitokset vastaavat aiottua suunnitelmaa.

Säilytä valittu malliversio pyynnön yhteydessä. Tripon generointirajapinta yksilöi toiminnon erillään malliversioasetuksesta, ja dokumentoitu tekstistä malliksi -esimerkki valitsee version nimenomaisesti. Säilytä täsmällinen versio ja asetukset malliaineistoja vertaillessasi, jotta kohdekuvauksen muutosta ei sekoiteta generointiasetusten muutokseen.

Geometria ja pinnan ulkoasu ovat erillisiä tuotantopäätöksiä. Valmistajan perustyönkulku erottaa teksturoimattoman mallin tulosteesta, jossa on tekstuureja ja fysikaalispohjaisen renderöinnin materiaaleja. Valitse seuraavassa vaiheessa tarvittava aineiston muoto ja tarkista sitten sekä polygoniverkko että mahdolliset mukana tulevat materiaalitiedostot. Esikatselukuva auttaa hahmottamisessa, mutta varsinaista mallia tarvitaan kohtauksen kokoamiseen ja jatkomuokkaukseen.

Tarkastele valmista kohdetta useasta suunnasta. Katso siluettia, osien erottumista, ohuita piirteitä, aukkoja ja pintoja, joilla osat kohtaavat. Vertaa tyylitellyn rekvisiitan mittasuhteita suunnittelukuvaukseen. Tarkista tuotetta muistuttavasta kohteesta, mitkä yksityiskohdat esitetään geometrialla ja mitkä näkyvät vain pintakäsittelyssä. Määritä korjattava piirre ennen kehotteen tai referenssin muuttamista.

Generointi suoritetaan asynkronisena tehtävänä. Säilytä alkuperäisen tehtävän tunniste tilan tarkistamisen ajan ja pidä valmis malli, esikatselu ja muut palautetut tiedostot yhdessä. Dokumentoitu tulos sisältää malliin liittyviä tuloskenttiä ja renderöityjä kuvia. Tallenna itse tiedostot seuraavaa tuotantovaihetta varten sen sijaan, että luottaisit väliaikaiseen tuloslinkkiin tai pitäisit esikatselua koko 3D-toimituksena.

Tuo malli aiottuun editoriin tai katseluympäristöön ja tarkista siellä sen suuntaus, mittakaava, materiaalit ja geometria. Kohtauksen rekvisiitta, lähikuvan renderöinti ja animaatiovalmis hahmo edellyttävät erilaista viimeistelyä. Pidä muokkauksia varten työkopio ja säilytä generoitu lähdemalli sen kuvauksen ja referenssien kanssa. Kun tarvitaan toinen toiminto, kuten teksturointityö tai riggaus, valitse se suunnitelmallisesti ja tarkista tuotettu malliaineisto erillisenä vaiheena.

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

tripo3d

Tripo /tripo3d

Aloitus

Hyväksytyt syötteet: Teksti
Tulokset: model_3d · Kuvat

Saatavilla Ailootissa · syötteet & menetelmät

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

Syötetyypit: text
Tulostyypit: model_3d, image

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat tripo3d Ehdot: Käytä Ailoot-mallin valitsinta.	Oletus—
Kenttä`type`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Ehdot: Koko esimerkki käyttää text_to_model-tilaa; muut tehtävätyypit edellyttävät dokumentoituja tehtäväkohtaisia syötteitään.	Oletus—
Kenttä`model_version`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Ehdot: Valitse nimenomaisesti dokumentoitu versio; tässä esimerkissä käytetään versiota v3.0-20250812.	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Ehdot: Kuvaile luotava kohde.	Oletus—

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, type, model_version, prompt
Parametri`optional`	Sopimus
Parametri`material_types`	Sopimustext
Parametri`conditions`	SopimusKäytä Ailoot-mallin valitsinta., Koko esimerkki käyttää text_to_model-tilaa; muut tehtävätyypit edellyttävät dokumentoituja tehtäväkohtaisia syötteitään., Valitse nimenomaisesti dokumentoitu versio; tässä esimerkissä käytetään versiota v3.0-20250812., Kuvaile luotava kohde.

Elinkaari: submit_once_poll_original

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $1.35 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · 3D

curl · luo vain kerran ja säilytä kuittiLue alkuperäinen tehtäväTallenna kaikki valmistuneet omat tuotokset

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

Vastaanota ja tallenna tulokset

Ailoot Ultra · 3D

Lataa jokainen palautettu kuva tai tallenna sen Base64-sisältö

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

Säilytä kaikki valmistuneet tulokset

Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.

Säilytä koko vastaus ja otsakkeet, alkuperäiset tunnisteet, jokainen todellinen tulos sekä kaikki käyttö- ja veloitustietokentät. Tallenna jokainen yksilöllinen käyttäjälle kuuluva aineisto ja säilytä kaikki siihen viittaavat roolit.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu julkinen tehtävän tai operaation id ja kaikki otsakkeet. Lue vain alkuperäisen tehtävän tietoja; unknown tai result_pending_check ei oikeuta uuteen luontipyyntöön.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`id`	Tyyppistring
Kenttä`polling_url`	Tyyppistring
Kenttä`provider_task_id`	Tyyppistring
Kenttä`code`	Tyyppiinteger
Kenttä`data.task_id`	Tyyppistring
Kenttä`data.status`	Tyyppistring
Kenttä`data.progress`	Tyyppiinteger
Kenttä`data.output.*`	Tyyppistring
Kenttä`data.result.*.url`	Tyyppistring
Kenttä`data.result.*.type`	Tyyppistring
Kenttä`data.thumbnail`	Tyyppistring

Aliakset

Mallin aliakset

Ailoot Ultra tripo3d

Menetelmäpolkujen aliakset

Käytä yllä näytettyjä menetelmäpolkuja.

Liittyvät kutsujan ID:t

tripo3d

FAQ · Tripo: 3D Generation

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/3d/generations · tripo3d: text → model_3d, image
Mitä kenttiä pyyntö käyttää?: POST /v1/3d/generations · tripo3d: model, type, model_version, prompt

Tripo: 3D Generation