Tripo tworzy zasoby w postaci modeli 3D z opisu lub referencji wizualnej. Jego procesy oddzielają wygenerowanie obiektu od późniejszych kroków, takich jak teksturowanie, rigging i konwersja. Zacznij od wskazania zamierzonego zasobu i operacji, która go wytwarza: statycznej siatki do sceny, obiektu z teksturami do renderowania lub modelu przygotowywanego dalej w edytorze 3D.
Przy opisie tekstowym do tworzenia modelu przedstaw kształt obiektu i jego ważne części. Małą latarnię można określić przez korpus, uchwyt, otwory i proporcje; stworzenie przez sylwetkę, kończyny i pozę. Podaj materiał lub sposób wizualnego opracowania, gdy ma znaczenie dla wyniku. Skup opis na samym obiekcie, aby wygenerowaną geometrię można było ocenić względem jasnego projektu.
W procesie producenta opartym na referencjach przygotuj obrazy pokazujące obrys obiektu i jego charakterystyczne cechy. Kilka ujęć powinno przedstawiać ten sam obiekt ze spójnymi proporcjami i akcesoriami. Sprawdź po generowaniu części ukryte w referencji, ponieważ przekonujący widok z przodu nie dowodzi, że tył, spód lub połączenia elementów odpowiadają zamierzonemu projektowi.
Zachowaj wybraną wersję modelu przy żądaniu. Interfejs generowania Tripo identyfikuje operację osobno od ustawienia wersji modelu, a udokumentowany przykład tekstowego tworzenia modelu wybiera jawną wersję. Przy porównywaniu zasobów zachowaj dokładną wersję i ustawienia, aby zmiana opisu obiektu nie została pomylona ze zmianą konfiguracji generowania.
Geometria i wygląd powierzchni są osobnymi decyzjami produkcyjnymi. Bazowy proces producenta odróżnia model bez tekstur od wyniku z teksturami i materiałami do renderowania opartego na fizyce. Wybierz postać zasobu potrzebną w następnym kroku, a następnie sprawdź siatkę i towarzyszące pliki materiałów. Obraz podglądu ułatwia orientację, a rzeczywisty model jest zasobem potrzebnym do składania sceny i dalszej edycji.
Zbadaj ukończony obiekt pod kilkoma kątami. Sprawdź sylwetkę, rozdzielenie części, cienkie elementy, otwory i powierzchnie styku komponentów. Przy stylizowanym rekwizycie porównaj proporcje z założeniami projektu. Przy obiekcie przypominającym produkt sprawdź, które szczegóły są przedstawione geometrią, a które występują tylko w opracowaniu powierzchni. Wskaż cechę wymagającą poprawy przed zmianą promptu lub referencji.
Generowanie przebiega jako zadanie asynchroniczne. Zachowaj identyfikator pierwotnego zadania podczas sprawdzania statusu i przechowuj razem ukończony model, podgląd i wszystkie pozostałe zwrócone pliki. Udokumentowany wynik obejmuje pola wyjściowe związane z modelem i renderowane obrazy. Zapisz same pliki do następnego kroku produkcyjnego, zamiast polegać na tymczasowym odnośniku wyniku lub traktować podgląd jako kompletny zasób 3D.
Zaimportuj model do docelowego edytora lub środowiska oglądania i sprawdź tam jego orientację, skalę, materiały i geometrię. Rekwizyt sceny, render z bliska i postać gotowa do animacji mają różne potrzeby wykończenia. Zachowaj kopię roboczą do edycji i wygenerowany zasób źródłowy wraz z opisem i referencjami. Gdy potrzebna jest kolejna operacja, taka jak praca z teksturami lub rigging, wybierz ją świadomie i sprawdź wynikowy zasób jako osobny etap.
", "aboutText": "Tripo tworzy zasoby w postaci modeli 3D z opisu lub referencji wizualnej. Jego procesy oddzielają wygenerowanie obiektu od późniejszych kroków, takich jak teksturowanie, rigging i konwersja. Zacznij od wskazania zamierzonego zasobu i operacji, która go wytwarza: statycznej siatki do sceny, obiektu z teksturami do renderowania lub modelu przygotowywanego dalej w edytorze 3D.\n\nPrzy opisie tekstowym do tworzenia modelu przedstaw kształt obiektu i jego ważne części. Małą latarnię można określić przez korpus, uchwyt, otwory i proporcje; stworzenie przez sylwetkę, kończyny i pozę. Podaj materiał lub sposób wizualnego opracowania, gdy ma znaczenie dla wyniku. Skup opis na samym obiekcie, aby wygenerowaną geometrię można było ocenić względem jasnego projektu.\n\nW procesie producenta opartym na referencjach przygotuj obrazy pokazujące obrys obiektu i jego charakterystyczne cechy. Kilka ujęć powinno przedstawiać ten sam obiekt ze spójnymi proporcjami i akcesoriami. Sprawdź po generowaniu części ukryte w referencji, ponieważ przekonujący widok z przodu nie dowodzi, że tył, spód lub połączenia elementów odpowiadają zamierzonemu projektowi.\n\nZachowaj wybraną wersję modelu przy żądaniu. Interfejs generowania Tripo identyfikuje operację osobno od ustawienia wersji modelu, a udokumentowany przykład tekstowego tworzenia modelu wybiera jawną wersję. Przy porównywaniu zasobów zachowaj dokładną wersję i ustawienia, aby zmiana opisu obiektu nie została pomylona ze zmianą konfiguracji generowania.\n\nGeometria i wygląd powierzchni są osobnymi decyzjami produkcyjnymi. Bazowy proces producenta odróżnia model bez tekstur od wyniku z teksturami i materiałami do renderowania opartego na fizyce. Wybierz postać zasobu potrzebną w następnym kroku, a następnie sprawdź siatkę i towarzyszące pliki materiałów. Obraz podglądu ułatwia orientację, a rzeczywisty model jest zasobem potrzebnym do składania sceny i dalszej edycji.\n\nZbadaj ukończony obiekt pod kilkoma kątami. Sprawdź sylwetkę, rozdzielenie części, cienkie elementy, otwory i powierzchnie styku komponentów. Przy stylizowanym rekwizycie porównaj proporcje z założeniami projektu. Przy obiekcie przypominającym produkt sprawdź, które szczegóły są przedstawione geometrią, a które występują tylko w opracowaniu powierzchni. Wskaż cechę wymagającą poprawy przed zmianą promptu lub referencji.\n\nGenerowanie przebiega jako zadanie asynchroniczne. Zachowaj identyfikator pierwotnego zadania podczas sprawdzania statusu i przechowuj razem ukończony model, podgląd i wszystkie pozostałe zwrócone pliki. Udokumentowany wynik obejmuje pola wyjściowe związane z modelem i renderowane obrazy. Zapisz same pliki do następnego kroku produkcyjnego, zamiast polegać na tymczasowym odnośniku wyniku lub traktować podgląd jako kompletny zasób 3D.\n\nZaimportuj model do docelowego edytora lub środowiska oglądania i sprawdź tam jego orientację, skalę, materiały i geometrię. Rekwizyt sceny, render z bliska i postać gotowa do animacji mają różne potrzeby wykończenia. Zachowaj kopię roboczą do edycji i wygenerowany zasób źródłowy wraz z opisem i referencjami. Gdy potrzebna jest kolejna operacja, taka jak praca z teksturami lub rigging, wybierz ją świadomie i sprawdź wynikowy zasób jako osobny etap.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "d789ceb8fd8bbb17a80a5579ec187616b2c7ffab511e69df3f39b3389d213c7f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "tripo3dTripo tworzy model 3D z pisemnego opisu obiektu. Szersze procesy producenta rozdzielają geometrię, teksturowanie i późniejsze przetwarzanie modelu; sprawdź ukończoną siatkę z kilku stron i zachowaj rzeczywiste pliki do docelowej sceny lub edytora.
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
Tripo tworzy zasoby w postaci modeli 3D z opisu lub referencji wizualnej. Jego procesy oddzielają wygenerowanie obiektu od późniejszych kroków, takich jak teksturowanie, rigging i konwersja. Zacznij od wskazania zamierzonego zasobu i operacji, która go wytwarza: statycznej siatki do sceny, obiektu z teksturami do renderowania lub modelu przygotowywanego dalej w edytorze 3D.
Przy opisie tekstowym do tworzenia modelu przedstaw kształt obiektu i jego ważne części. Małą latarnię można określić przez korpus, uchwyt, otwory i proporcje; stworzenie przez sylwetkę, kończyny i pozę. Podaj materiał lub sposób wizualnego opracowania, gdy ma znaczenie dla wyniku. Skup opis na samym obiekcie, aby wygenerowaną geometrię można było ocenić względem jasnego projektu.
W procesie producenta opartym na referencjach przygotuj obrazy pokazujące obrys obiektu i jego charakterystyczne cechy. Kilka ujęć powinno przedstawiać ten sam obiekt ze spójnymi proporcjami i akcesoriami. Sprawdź po generowaniu części ukryte w referencji, ponieważ przekonujący widok z przodu nie dowodzi, że tył, spód lub połączenia elementów odpowiadają zamierzonemu projektowi.
Zachowaj wybraną wersję modelu przy żądaniu. Interfejs generowania Tripo identyfikuje operację osobno od ustawienia wersji modelu, a udokumentowany przykład tekstowego tworzenia modelu wybiera jawną wersję. Przy porównywaniu zasobów zachowaj dokładną wersję i ustawienia, aby zmiana opisu obiektu nie została pomylona ze zmianą konfiguracji generowania.
Geometria i wygląd powierzchni są osobnymi decyzjami produkcyjnymi. Bazowy proces producenta odróżnia model bez tekstur od wyniku z teksturami i materiałami do renderowania opartego na fizyce. Wybierz postać zasobu potrzebną w następnym kroku, a następnie sprawdź siatkę i towarzyszące pliki materiałów. Obraz podglądu ułatwia orientację, a rzeczywisty model jest zasobem potrzebnym do składania sceny i dalszej edycji.
Zbadaj ukończony obiekt pod kilkoma kątami. Sprawdź sylwetkę, rozdzielenie części, cienkie elementy, otwory i powierzchnie styku komponentów. Przy stylizowanym rekwizycie porównaj proporcje z założeniami projektu. Przy obiekcie przypominającym produkt sprawdź, które szczegóły są przedstawione geometrią, a które występują tylko w opracowaniu powierzchni. Wskaż cechę wymagającą poprawy przed zmianą promptu lub referencji.
Generowanie przebiega jako zadanie asynchroniczne. Zachowaj identyfikator pierwotnego zadania podczas sprawdzania statusu i przechowuj razem ukończony model, podgląd i wszystkie pozostałe zwrócone pliki. Udokumentowany wynik obejmuje pola wyjściowe związane z modelem i renderowane obrazy. Zapisz same pliki do następnego kroku produkcyjnego, zamiast polegać na tymczasowym odnośniku wyniku lub traktować podgląd jako kompletny zasób 3D.
Zaimportuj model do docelowego edytora lub środowiska oglądania i sprawdź tam jego orientację, skalę, materiały i geometrię. Rekwizyt sceny, render z bliska i postać gotowa do animacji mają różne potrzeby wykończenia. Zachowaj kopię roboczą do edycji i wygenerowany zasób źródłowy wraz z opisem i referencjami. Gdy potrzebna jest kolejna operacja, taka jak praca z teksturami lub rigging, wybierz ją świadomie i sprawdź wynikowy zasób jako osobny etap.
POST /v1/3d/generationstextmodel_3d, image| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity tripo3d Warunki: Użyj selektora modelu Ailoot. | Domyślnie— |
Poletype | Typstring | WymaganieWymagane | Wartości i limity text_to_model, image_to_model, multiview_to_model, texture_model, animate_prerigcheck, animate_rig, animate_retarget, stylize_model, convert_model Warunki: Kompletny przykład używa text_to_model; inne typy zadań wymagają udokumentowanych danych wejściowych właściwych dla danego zadania. | Domyślnie— |
Polemodel_version | Typstring | WymaganieWymagane | Wartości i limity v2.0-20240919, v1.4-20240625, v2.5-20250123, v3.0-20250812, Turbo-v1.0-20250506 Warunki: Wybierz wersję wyraźnie wskazaną w dokumentacji; ten przykład używa v3.0-20250812. | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Warunki: Opisz obiekt, który chcesz utworzyć. | Domyślnie— |
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, type, model_version, prompt |
Parametroptional | Kontrakt |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktUżyj selektora modelu Ailoot., Kompletny przykład używa text_to_model; inne typy zadań wymagają udokumentowanych danych wejściowych właściwych dla danego zadania., Wybierz wersję wyraźnie wskazaną w dokumentacji; ten przykład używa v3.0-20250812., Opisz obiekt, który chcesz utworzyć. |
Cykl życia: submit_once_poll_original
GET /v1/3d/generations/{request_id}
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $1.35 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
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\nPobierz każdy zwrócony obraz lub zapisz jego zawartość Base64
GET /v1/3d/generations/{request_id}GET /v1/media/assetsGET /v1/media/assets/{asset_id}Zachowaj każdą kompletną zwróconą odpowiedź, plik i część treści.
Zachowaj kompletną odpowiedź i nagłówki, pierwotne identyfikatory, wszystkie rzeczywiste wyniki oraz wszystkie pola użycia i rozliczeń. Zapisz każdy unikalny zasób należący do użytkownika i zachowaj wszystkie role, które na niego wskazują.
Zachowaj zwrócone publiczne id zadania lub operacji oraz wszystkie nagłówki. Odczytuj wyłącznie pierwotne zadanie; unknown ani result_pending_check nie uprawniają do ponownego utworzenia.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polepolling_url | Typstring |
Poleprovider_task_id | Typstring |
Polecode | Typinteger |
Poledata.task_id | Typstring |
Poledata.status | Typstring |
Poledata.progress | Typinteger |
Poledata.output.* | Typstring |
Poledata.result.*.url | Typstring |
Poledata.result.*.type | Typstring |
Poledata.thumbnail | Typstring |
Ailoot Ultra tripo3d
Użyj ścieżek metod podanych powyżej.