Tekst na 3D API

To pole powinno być ustawione na „preview” podczas tworzenia zadania podglądu.

Opisz, jakim obiektem ma być model 3D. Maksymalnie 800 znaków.

Określ typ generowania siatki 3D.

Dostępne wartości:

• standard: Zwykłe generowanie siatki 3D o wysokim poziomie szczegółowości.
• smart-topology: Wybierz model Smart Topology za pomocą ai_model (meshy-t2).
• lowpoly (przestarzałe): Generuje siatkę low-poly zoptymalizowaną pod kątem czystszych wielokątów. Zalecamy używanie zamiast tego smart-topology.

Identyfikator modelu, który ma zostać użyty. Dostępne wartości zależą od model_type.

Generowanie standardowe (model_type: standard):

• meshy-5, meshy-6, meshy-7, latest (Meshy 7)

Generowanie Smart Topology (model_type: smart-topology):

• meshy-t2 (domyślnie): model Smart Topology — czystsza topology, natywnie oddzielone części, wynik w postaci trójkątów oraz liczba ścian, którą można ustawić za pomocą target_polycount.

Włącza generowanie Ultra zapewniające geometrię wyższej wierności z bardziej precyzyjnymi szczegółami powierzchni. Generowanie trwa dłużej i kosztuje dodatkowe 5 kredytów.

Kontroluje, czy włączyć fazę remesh. W przypadku modelu o najwyższej jakości zalecamy ustawienie should_remesh na false.

Docelowa liczba wielokątów (ścian) w wyniku. Rzeczywista liczba może odbiegać od wartości docelowej w zależności od geometrii.

target_polycount ma zastosowanie w dwóch niezależnych przypadkach:

• Remesh — z should_remesh: true dla modelu standard. Siatka jest poddawana remesh (decymacji) do w przybliżeniu tej liczby. Zakres od 100 do 300 000, domyślnie 30 000. Jeśli ustawiony jest decimation_mode, ma on priorytet, a target_polycount jest ignorowany.
• Smart Topology — z model_type: smart-topology i ai_model: meshy-t2. Model jest generowany bezpośrednio z taką liczbą ścian; remesh nie jest uruchamiany, a should_remesh nie jest wymagany. Zakres od 100 do 15 000, domyślnie 4000.

Przestarzałe. Ten parametr nie wpływa już na wynik.

Pole symmetry_mode kontroluje zachowanie symetrii podczas procesu generowania modelu.

Prawidłowe wartości to:

• off: Wyłącza symetrię.
• auto: Automatycznie określa i stosuje symetrię na podstawie geometrii wejściowej.
• on: Wymusza symetrię podczas generowania.

Określ pose mode dla generowanego modelu.

Dostępne wartości:

• a-pose: Generuje model w pozie A.
• t-pose: Generuje model w pozie T.
• "" (pusty ciąg znaków): Nie zastosowano konkretnej pozy.

Użyj zamiast tego pose_mode. Określa, czy wygenerować model w pozie A/T.

Nieobsługiwane przez Meshy-6. Żądania korzystające z Meshy-6 będą ignorować art_style, a niektóre kombinacje mogą powodować błędy. Dostępne wartości: realistic, sculpture.

Gdy ustawione na true, treść wejściowa zostanie automatycznie sprawdzona pod kątem potencjalnie szkodliwych treści. Jeśli zostanie wykryta szkodliwa treść, zadanie nie przejdzie do etapu generowania.

Sprawdzany będzie tekst z pola prompt.

Określa, które formaty plików 3D mają zostać uwzględnione w wyniku. Wygenerowane i zwrócone zostaną tylko żądane formaty, co może skrócić czas realizacji zadania. Gdy pole zostanie pominięte, uwzględnione zostaną wszystkie obsługiwane formaty.

Dostępne wartości: glb, obj, fbx, stl, usdz, 3mf

Gdy ustawione na true, zadanie dodatkowo renderuje wersję podglądu z przezroczystym tłem (RGBA) i zwraca ją jako alpha_thumbnail_url w odpowiedzi GET. Istniejące pole thumbnail_url pozostaje bez zmian.

Gdy ustawione na true, usługa wykorzystuje wizję AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniej zmiany rozmiaru modelu. Punkt początkowy będzie domyślnie ustawiony na bottom, chyba że origin_at zostanie jawnie ustawiony.

Żądanie było niepoprawne. Typowe przyczyny:

• Brakujący parametr: Brak wymaganego parametru (np. prompt, mode).
• Nieprawidłowy parametr: art_style nie jest jedną z dozwolonych wartości.
• Zbyt długi prompt: prompt przekracza limit znaków.

Uwierzytelnianie nie powiodło się. Sprawdź swój klucz API.

Niewystarczająca liczba kredytów, aby wykonać to zadanie.

Przekroczono limit szybkości.

To pole powinno być ustawione na "refine" podczas tworzenia zadania refine.

Odpowiedni identyfikator zadania podglądu.

Status podanego zadania podglądu musi mieć wartość SUCCEEDED.

Generuje mapy PBR (metallic, roughness, normal) oprócz podstawowego koloru. Mapa emisji jest również dołączana, gdy ai_model ma wartość meshy-6, z wyjątkiem texture_resolution: 8k (w takim przypadku mapa emisji nie jest generowana). meshy-7 (oraz latest) nie generuje mapy emisji.

Rozdzielczość tekstury podstawowego koloru. Jedna z wartości: 2k (2048×2048), 4k (4096×4096) lub 8k (8192×8192). Wyższe rozdzielczości pozwalają uchwycić więcej szczegółów powierzchni. Dotyczy tylko trybu refine.

Zamiast tego użyj texture_resolution — jest to odpowiednik texture_resolution: "4k". Gdy oba parametry są ustawione, pierwszeństwo ma texture_resolution.

Podaj dodatkowy prompt tekstowy, aby ukierunkować proces teksturowania. Maksymalnie 800 znaków.

Podaj obraz 2D, aby ukierunkować proces teksturowania. Obecnie obsługujemy formaty .jpg, .jpeg oraz .png.

Istnieją dwa sposoby dostarczenia obrazu:

• Publicznie dostępny URL: adres URL dostępny z publicznego internetu
• Data URI: zakodowany w base64 Data URI obrazu. Przykład Data URI: data:image/jpeg;base64,<dane obrazu zakodowane w base64>

Identyfikator modelu używanego do refine. Dostępne wartości: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Pomiń ten parametr, aby odziedziczyć model użyty w zadaniu podglądu, co utrzymuje podgląd i jego refine na tym samym modelu od początku do końca. Podaj jawną wartość, aby nadpisać to dziedziczenie.

Gdy ustawione na true, wprowadzona treść zostanie automatycznie sprawdzona pod kątem potencjalnie szkodliwej zawartości. Jeśli zostanie wykryta szkodliwa treść, zadanie nie przejdzie do etapu generowania.

Sprawdzany będzie zarówno tekst z texture_prompt, jak i obraz z texture_image_url.

Usuwa refleksy świetlne i cienie z tekstury podstawowego koloru, dając czystszy rezultat, który lepiej sprawdza się przy niestandardowych ustawieniach oświetlenia.

Określa, które formaty plików 3D mają zostać uwzględnione w wyniku. Generowane i zwracane będą tylko żądane formaty, co może skrócić czas realizacji zadania. Gdy pominięte, uwzględniane są wszystkie obsługiwane formaty.

Dostępne wartości: glb, obj, fbx, stl, usdz, 3mf

Gdy ustawione na true, zadanie dodatkowo renderuje wersję podglądu z przezroczystym tłem (RGBA) i zwraca ją jako alpha_thumbnail_url w odpowiedzi GET. Istniejące pole thumbnail_url pozostaje bez zmian.

Gdy ustawione na true, usługa wykorzystuje wizję AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniego zmienienia rozmiaru modelu. Punkt początkowy domyślnie ustawi się na bottom, chyba że origin_at zostanie jawnie ustawione.

Żądanie było niedopuszczalne. Typowe przyczyny:

• Nieprawidłowy identyfikator zadania: preview_task_id jest nieprawidłowy lub nie istnieje.
• Zadanie nie jest gotowe: zadanie podglądu jeszcze się nie powiodło.
• Niezgodność modelu: model AI zadania podglądu jest niekompatybilny z żądanym modelem refine.

Uwierzytelnianie nie powiodło się. Sprawdź swój klucz API.

Niewystarczająca liczba kredytów do wykonania tego zadania.

Nie znaleziono zadania podglądu określonego przez preview_task_id.

Przekroczono limit szybkości.

Unikalny identyfikator zadania Tekst na 3D do pobrania.

ID zadania Tekst na 3D do usunięcia.

Numer strony do stronicowania.

Limit rozmiaru strony. Maksymalna dozwolona wartość to 50 elementów.

Pole, według którego ma nastąpić sortowanie.

Dostępne wartości:

• +created_at: Sortuj według czasu utworzenia rosnąco.
• -created_at: Sortuj według czasu utworzenia malejąco.

Unikalny identyfikator zadania Tekst na 3D do strumieniowania.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy identyfikatorów zadań w formacie k-sortable UUID, nie należy przyjmować żadnych założeń co do formatu identyfikatora.

Typ zadania Tekst na 3D. Możliwe wartości to text-to-3d-preview dla zadań etapu preview i text-to-3d-refine dla zadań etapu refine.

Adres URL do pobrania pliku teksturowanego modelu 3D wygenerowanego przez Meshy. Właściwość dla danego formatu zostanie pominięta, jeśli format nie został wygenerowany, zamiast zwracać pusty ciąg znaków.

Jest to niezmodyfikowany prompt, który został użyty do utworzenia zadania.

Zachowane dla zgodności wstecznej. To pole nie ma żadnego wpływu funkcjonalnego na generowane modele.

Niezmodyfikowany art_style, który został użyty do utworzenia zadania preview. Nieobsługiwane przez Meshy-6.

Zachowane dla zgodności wstecznej. To pole nie ma żadnego wpływu funkcjonalnego na generowane modele.

Dodatkowy prompt tekstowy dostarczony w celu ukierunkowania procesu teksturowania podczas etapu refine.

Odzwierciedla wartość ultra_mode, z jaką zostało utworzone zadanie preview. Obecne tylko dla zadań preview meshy-7 (lub latest), które jawnie ustawiły ultra_mode; w przeciwnym razie pominięte.

Adres URL do pobrania obrazu tekstury, który został użyty do ukierunkowania procesu teksturowania.

Adres URL do pobrania miniatury pliku modelu.

Adres URL do pobrania wersji thumbnail_url z przezroczystym tłem (RGBA). Obecne tylko wtedy, gdy zadanie zostało utworzone z alpha_thumbnail: true i przezroczysty podgląd został pomyślnie wyrenderowany; w przeciwnym razie to pole jest pomijane.

Adres URL do pobrania wideo podglądowego. Zostanie usunięte w przyszłej wersji.

Postęp zadania. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość będzie miała wartość 0. Po zakończeniu zadania powodzeniem, wartość ta zmieni się na 100.

Znacznik czasu określający, kiedy zadanie zostało rozpoczęte, w milisekundach. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość będzie miała wartość 0.

Znacznik czasu określający, kiedy zadanie zostało utworzone, w milisekundach.

Znacznik czasu określający, kiedy zadanie zostało zakończone, w milisekundach. Jeśli zadanie nie zostało jeszcze zakończone, ta właściwość będzie miała wartość 0.

Status zadania. Możliwe wartości to jedna z: PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Tablica obiektów URL tekstur wygenerowanych z zadania. Zazwyczaj zawiera ona tylko jeden obiekt URL tekstury. Każdy URL tekstury ma następujące właściwości:

Liczba poprzedzających zadań.

Szczegóły błędu dla zadań zakończonych niepowodzeniem. Pełny opis obiektu task_error znajdziesz w sekcji Błędy.

Liczba kredytów zużytych przez to zadanie. Obecne, gdy status zadania to PENDING, IN_PROGRESS lub SUCCEEDED. Zwraca 0 dla zadań FAILED (kredyty są zwracane w przypadku niepowodzenia).