API Tekst na 3D

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

Opisz, jakiego rodzaju obiektem jest model 3D. Maksymalnie 800 znaków.

Określ typ generowania siatki 3D.

Dostępne wartości:

• standard: Zwykłe generowanie siatki 3D o wysokiej 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 do użycia. 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ślne): 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 dla geometrii o wyższej wierności z dokładniejszymi szczegółami powierzchni. Generowanie trwa dłużej i dolicza 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 ustawiono 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 tą liczbą ścian; nie wykonuje się remesh i should_remesh nie jest wymagane. Zakres od 100 do 15 000, domyślnie 4 000.

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 tryb pozy 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 żadnej konkretnej pozy.

Zamiast tego użyj 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 szkodliwej zawartości. Jeśli zostanie wykryta szkodliwa treść, zadanie nie przejdzie do etapu generowania.

Sprawdzeniu zostanie poddany tekst z pola prompt.

Określa, które formaty plików 3D mają zostać uwzględnione w wyniku. Zostaną wygenerowane i zwrócone tylko żądane formaty, co może skrócić czas realizacji zadania. Gdy pominięte, uwzględnione 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, aby automatycznie oszacować rzeczywistą wysokość obiektu i odpowiednio zmienić rozmiar modelu. Punkt początkowy domyślnie przyjmuje wartość bottom, chyba że origin_at zostanie jawnie ustawiony.

Żądanie było nieprawidłowe. 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 do wykonania tego zadania.

Przekroczono limit szybkości.

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

Odpowiadające id zadania podglądu.

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

Generuje mapy PBR (metaliczność, chropowatość, normalna) oprócz koloru bazowego. 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 koloru bazowego. 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.

Użyj zamiast tego texture_resolution — odpowiednika 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 i .png.

Istnieją dwa sposoby dostarczenia obrazu:

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

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

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

Zarówno tekst z texture_prompt, jak i obraz z texture_image_url zostaną przeskanowane.

Usuwa podświetlenia i cienie z tekstury koloru bazowego, 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 ukończenia 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 korzysta z wizji AI, aby automatycznie oszacować rzeczywistą wysokość obiektu i odpowiednio przeskalować model. Punkt początkowy domyślnie przyjmie wartość bottom, chyba że origin_at zostanie jawnie ustawione.

Żądanie było niepoprawne. 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 niezgodny 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 dla zadania Tekst na 3D do pobrania.

ID zadania Tekst na 3D do usunięcia.

Numer strony dla stronicowania.

Limit rozmiaru strony. Maksymalnie dozwolone to 50 elementów.

Pole do sortowania.

Dostępne wartości:

• +created_at: Sortuj według czasu utworzenia w porządku rosnącym.
• -created_at: Sortuj według czasu utworzenia w porządku malejącym.

Unikalny identyfikator dla zadania Tekst na 3D do przesyłania.

Unikalny identyfikator dla zadania. Chociaż używamy UUID sortowalnego przez k dla identyfikatorów zadań jako szczegółu implementacji, nie powinieneś zakładać żadnego formatu identyfikatora.

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

Pobieralny URL do pliku modelu 3D z teksturą wygenerowanego przez Meshy. Właściwość dla formatu zostanie pominięta, jeśli format nie zostanie wygenerowany, zamiast zwracania pustego ciągu.

To jest niezmodyfikowany prompt, który został użyty do stworzenia zadania.

Utrzymywany dla zgodności wstecznej. To pole nie ma wpływu na generowane modele.

Niezmieniony art_style, który został użyty do stworzenia zadania podglądu. Nieobsługiwany przez Meshy-6.

Utrzymywany dla zgodności wstecznej. To pole nie ma wpływu na generowane modele.

Dodatkowy tekstowy prompt dostarczony w celu kierowania procesem teksturowania podczas etapu dopracowania.

Odbija wartość ultra_mode, z którą zostało stworzone zadanie podglądu. Obecny tylko dla zadań podglądu meshy-7 (lub latest), które wyraźnie ustawiły ultra_mode; w przeciwnym razie pominięty.

Pobieralny URL do obrazu tekstury, który został użyty do kierowania procesem teksturowania.

Pobieralny URL do obrazu miniatury pliku modelu.

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

Pobieralny URL do wideo podglądu. Zostanie usunięty 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. Gdy zadanie zakończy się sukcesem, stanie się 100.

Znacznik czasu, 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, kiedy zadanie zostało utworzone, w milisekundach.

Znacznik czasu, 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 PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Tablica obiektów URL tekstur, które są generowane z zadania. Zwykle zawiera 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 nieudanych zadań. Zobacz Błędy dla pełnej referencji obiektu task_error.

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).