01
hunyuan-3d/v3.1/pro/image-to-3d
Zamień obraz obiektu z przodu w zasób 3D, korzystając z ustawień Pro dla PBR, trybu geometrii, własnej liczby ścian i opcjonalnych dodatkowych widoków.
hunyuan-3d/v3.1/pro/text-to-3d
Model:
Hunyuan 3D v3.1 API obsługuje generowanie 3D z tekstu i z obrazu w wariantach Pro i Rapid dla gier, wizualizacji produktów, prototypowania i produkcji zasobów 3D.
Examples
Szczegóły cennika
Płatność za użycie. Bez subskrypcji i ukrytych opłat.
| Poziom | Tekst na 3D | Obraz na 3D |
|---|---|---|
| Pro | $0.300/gen. Kredyty: 60/gen. $0.375/gen.Oszczędzasz 20% | $0.300/gen. Kredyty: 60/gen. $0.375/gen.Oszczędzasz 20% |
| Rapid | $0.180/gen. Kredyty: 36/gen. $0.225/gen.Oszczędzasz 20% | $0.180/gen. Kredyty: 36/gen. $0.225/gen.Oszczędzasz 20% |
Przykładowy koszt (Rapid · Tekst na 3D · Generowanie bazowe): Generowania (10): $1.80
Dodatki
| Poziom | Cena PoYo | Oryginał / rabat |
|---|---|---|
| Pro · Obraz na 3D · Materiały PBR | +$0.120 Kredyty: 24 | +$0.150Oszczędzasz 20% Oficjalne |
| Pro · Obraz na 3D · Wejście wielowidokowe | +$0.120 Kredyty: 24 | +$0.150Oszczędzasz 20% Oficjalne |
| Pro · Tekst na 3D · Własna liczba ścian | +$0.120 Kredyty: 24 | +$0.150Oszczędzasz 20% Oficjalne |
Jak jest rozliczane: Stała cena za generowanie. Dodatki są rozliczane ponad cenę bazową.
Opłaty zależą od końcowego wyniku.
Wprowadzenie
Kompletny przewodnik: Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 w PoYo.ai udostępnia cztery modele z jednolitym wysyłaniem zadań, sprawdzaniem statusu, obsługą callbacków i możliwością pobrania wyników 3D po zakończeniu generowania.
Dostępne modele
Pobierz klucz API
02
hunyuan-3d/v3.1/pro/text-to-3d
Zacznij od dłuższego promptu tekstowego i użyj opcji Pro, takich jak PBR, tryb geometrii i własna liczba ścian, aby lepiej kontrolować generowanie zasobu.
03
hunyuan-3d/v3.1/rapid/text-to-3d
Generuj szybkie szkice 3D z krótszych promptów w cenie Rapid, z opcjonalnymi ustawieniami PBR lub wyjścia nastawionego na geometrię.
04
hunyuan-3d/v3.1/rapid/image-to-3d
Zamień pojedynczy obraz obiektu w model 3D za pomocą tańszego modelu obrazowego Rapid, z opcjonalnymi ustawieniami PBR lub geometrii.
Kluczowe funkcje Hunyuan 3D v3.1 API
Wybierz modele Hunyuan 3D v3.1 Pro lub Rapid do generowania 3D z tekstu i z obrazu, z ustawieniami udostępnianymi przez PoYo i asynchronicznym dostępem przez API.
01
Pro: obraz na 3D ze wskazówkami z widoków
Prześlij jeden obraz obiektu z przodu i dodaj opcjonalne widoki z boku, z tyłu, z góry, z dołu lub pod kątem, gdy masz więcej materiału referencyjnego. Model obrazowy Pro obsługuje też opcje PBR, trybu geometrii i własnej liczby ścian.
- Obraz z przodu przesyłany jako image_urls w PoYo
- Opcjonalne pola obrazów z wielu widoków dla zadań obrazowych Pro
- Ustawienia PBR i własnej liczby ścian w razie potrzeby
02
Pro: tekst na 3D dla szczegółowych promptów
Użyj trybu Pro tekst na 3D, gdy pisemny opis obiektu ma wyznaczać kształt, kierunek materiałów i ogólną koncepcję zasobu. PoYo utrzymuje asynchroniczny przepływ API, więc sprawdzanie statusu i callbacki działają tak samo jak w innych modelach 3D.
- Prompt do limitu modelu Pro
- Opcjonalne PBR, tryb geometrii i liczba ścian
- Jednolity status i pobieranie plików
03
Rapid: tekst na 3D dla szybszych szkiców
Tryb Rapid tekst na 3D przydaje się do wczesnego generowania pomysłów, eksploracji obiektów i tańszych szkiców zasobów. Użyj go, gdy wystarczą krótkie prompty, a zespół potrzebuje szybkich porównań przed wyborem ostatecznego kierunku.
- Niższy bazowy koszt w kredytach niż w Pro
- Opcjonalne PBR, gdy nie wybrano trybu geometrii
- Dobre do eksploracji i iteracji zasobów
04
Rapid: obraz na 3D z jednej referencji
Użyj modelu obrazowego Rapid, gdy masz już produkt, rekwizyt, szkic lub referencję obiektu i chcesz szybko uzyskać wynik 3D. PoYo przyjmuje proste wejście image_urls i zwraca znormalizowane wyniki zadań.
- Jedno źródło obrazu dla modelu Rapid
- Opcje PBR lub geometrii tam, gdzie są obsługiwane
- Zwrócone miniatury i pliki modeli normalizuje PoYo
Zastosowania
01
Pomysły na rekwizyty do gier
Generuj wstępne koncepcje rekwizytów z promptów lub referencji obiektów, zanim poświęcisz czas na ręczne modelowanie.
02
Wizualizacja produktów i obiektów
Zamień referencje z przodu lub z wielu widoków w wyniki 3D na potrzeby przeglądu, prototypowania i dalszej produkcji zasobów.
03
Eksploracja zasobów 3D w trybie batch
Porównuj wyniki Pro i Rapid w jednym formacie API, zachowując spójny cennik, status zadań i pobieranie plików.
04
Asynchroniczny pipeline 3D
Wysyłaj zadania Hunyuan 3D z callbackami lub sprawdzaniem statusu i kieruj gotowe pliki modeli do narzędzi produkcyjnych.
Hunyuan 3D v3.1 Pro vs Rapid
Zestawienie czterech modeli Hunyuan 3D v3.1 dostępnych w PoYo.
| Funkcja | Pro | Rapid |
|---|---|---|
| Tryby wejścia | Tekst na 3D i obraz na 3D | Tekst na 3D i obraz na 3D |
| Najlepsze zastosowanie | Zadania wymagające większej kontroli: PBR, trybu geometrii, liczby ścian lub wskazówek z wielu widoków | Tańsze szkice i szybsza iteracja z promptów lub jednego obrazu |
| Długość promptu | Do 1024 znaków | Do 200 znaków |
| Ustawienia obrazu | Obraz z przodu plus opcjonalne adresy URL dodatkowych widoków w zadaniach obrazowych Pro | Pojedynczy obraz z przodu |
| Model cenowy | 60 kredytów bazowo, z opcjonalnymi dopłatami | 36 kredytów bazowo, z opcjonalną dopłatą za PBR |
Dokładnie dostępne wyniki zależą od wybranego modelu i zwróconych plików.
Jak korzystać z Hunyuan 3D v3.1 API w PoYo
Krok 1: utwórz klucz API
Zarejestruj się w PoYo i utwórz klucz API w sekcji dashboard.
Utwórz klucz API ->
Krok 2: wybierz model Hunyuan 3D v3.1
Wybierz jeden z czterech publicznych identyfikatorów modeli: Pro obraz, Pro tekst, Rapid tekst lub Rapid obraz.
Krok 3: wyślij dane wejściowe PoYo
Użyj prompt dla modeli tekstowych lub image_urls dla modeli obrazowych. Pola PBR, geometrii, liczby ścian lub wielu widoków dodawaj tylko wtedy, gdy wybrany model je obsługuje.
Krok 4: pobierz wygenerowane zasoby
Sprawdzaj endpoint statusu zadania albo podaj adres URL callbacku, a następnie pobierz zwrócone pliki GLB, OBJ, MTL, tekstur, miniatur lub adresy URL modeli, jeśli są dostępne.
Zobacz dokumentację ->
Cennik Hunyuan 3D v3.1 API
Hunyuan 3D v3.1 w PoYo jest rozliczany za generowanie, z opcjonalnymi dopłatami.
Modele Pro zaczynają się od 60 kredytów ($0.30) za generowanie. Modele Rapid zaczynają się od 36 kredytów ($0.18) za generowanie.
Obsługiwane dodatki kosztują po 24 kredyty ($0.12). Dodatki obejmują PBR, gdy ma zastosowanie, wejścia z wielu widoków w zadaniach obrazowych Pro oraz własną liczbę ścian w zadaniach Pro.
Doładuj kredyty i zacznij testować Hunyuan 3D v3.1 w PoYo. Doładuj kredyty ->
Najczęstsze pytania
Który model Hunyuan 3D v3.1 wybrać?
Użyj Pro, gdy potrzebujesz dodatkowych ustawień, takich jak PBR, tryb geometrii, własna liczba ścian lub wskazówki z wielu widoków obrazu. Użyj Rapid do tańszego szkicowania z tekstu lub jednego obrazu.
Jak działają wejścia obrazowe w PoYo?
Wysyłaj modele obrazowe z image_urls zawierającym jeden adres URL obrazu z przodu. PoYo utrzymuje spójny format danych wejściowych dla wszystkich modeli obrazowych Hunyuan 3D.
Czy mogę używać obrazów z wielu widoków?
Tak, ale tylko z hunyuan-3d/v3.1/pro/image-to-3d. Opcjonalne pola widoków to adresy URL obrazów: z tyłu, z lewej, z prawej, z góry, z dołu, z lewej z przodu i z prawej z przodu.
Jakie pliki może zwrócić API?
Wyniki mogą zawierać pliki GLB, OBJ, MTL, tekstury, miniatury i kolekcje adresów URL modeli, w zależności od wybranego modelu Hunyuan 3D v3.1.
Dlaczego warto korzystać z PoYo.ai
01
Jedno asynchroniczne API 3D
Używaj tego samego schematu wysyłania, statusu, callbacku i pobierania plików we wszystkich czterech modelach Hunyuan 3D v3.1.
02
Przejrzysty cennik w kredytach
Zobacz bazowe kredyty za generowanie i opłaty za dodatki, zanim wyślesz zadanie.
03
Ustawienia dopasowane do modelu
Playground pokazuje tylko ustawienia obsługiwane przez wybrany model Pro lub Rapid.
04
Znormalizowane pliki wyjściowe
PoYo zbiera zwrócone pliki modeli, tekstur i miniatur w spójny format wyniku zadania.