Source: https://ailoot.ai/models/fi/tripo3d/ Canonical: https://ailoot.ai/models/fi/tripo3d/ Language: fi # Tripo: 3D Generation [Markdown](https://ailoot.ai/models/fi/tripo3d/index.md) · [JSON](https://ailoot.ai/models/fi/tripo3d/facts.json) ## [Tripo: 3D Generation](https://ailoot.ai/models/fi/tripo3d/) 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`](https://ailoot.ai/models/fi/tripo3d/#method-0) 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`](https://ailoot.ai/models/fi/#m=tripo3d&route=Ultra&caller=tripo3d&fmt=3d) Tripo /`tripo3d` ### Aloitus 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. 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 →](https://ailoot.ai/docs/fi/billing/reserve/) ### Esimerkkipyynnöt #### Ailoot Ultra · 3D curl · luo vain kerran ja säilytä kuittiLue alkuperäinen tehtäväTallenna kaikki valmistuneet omat tuotokset ```bash 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. ``` ```bash 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 ``` ```bash 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`](https://ailoot.ai/models/fi/#m=tripo3d&route=Ultra&caller=tripo3d&fmt=3d) #### Menetelmäpolkujen aliakset Käytä yllä näytettyjä menetelmäpolkuja. #### Liittyvät kutsujan ID:t [`tripo3d`](https://ailoot.ai/models/fi/#m=tripo3d&route=Ultra&caller=tripo3d&fmt=3d) 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` Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi. ## Yritys ja sen projektisalkku Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. ## Osta tokenit alennuksella. Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista. Tilaus Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten. Kampanjakoodi jopa 50% Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan. Kulut historiassa Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle. [Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/) ## Yhdistä API tuotteeseen, jonka myyt. SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi. Kaupallinen sovellus Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin. Jälleenmyyjälisenssi Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot. Asiakirjat verkkosivustolla Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä. [Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi) ## Ailoot · Yritys ja sen projektisalkku Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan. Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa. Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.