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.
", "aboutText": "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.\n\nKuvaa 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.\n\nValmistele 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.\n\nSä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.\n\nGeometria 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.\n\nTarkastele 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.\n\nGenerointi 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.\n\nTuo 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "739202622c6cf931cc8c964a3249b404b006ac8b447f4802a00b3647b24056ff", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "tripo3dTripo 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.
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.
POST /v1/3d/generationstextmodel_3d, image| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat tripo3d Ehdot: Käytä Ailoot-mallin valitsinta. | Oletus— |
Kenttätype | Tyyppistring | 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 | Tyyppistring | 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 | Tyyppistring | VaatimusPakollinen | Arvot & rajat Ehdot: Kuvaile luotava kohde. | Oletus— |
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, type, model_version, prompt |
Parametrioptional | Sopimus |
Parametrimaterial_types | Sopimustext |
Parametriconditions | 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}
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncat > request.json <<'JSON'\n{\n "model": "tripo3d",\n "type": "text_to_model",\n "prompt": "a cute pig",\n "model_version": "v3.0-20250812"\n}\nJSON\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/3d/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Create once; retain id, polling_url, original task identifiers and every header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.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)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n 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"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n 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"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nLataa jokainen palautettu kuva tai tallenna sen Base64-sisältö
GET /v1/3d/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}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.
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.
| 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 |
Ailoot Ultra tripo3d
Käytä yllä näytettyjä menetelmäpolkuja.