API Tekst na 3D

To pole powinno być ustawione na "preview", gdy tworzysz zadanie podglądu.

Opisz, jaki rodzaj obiektu ma mieć model 3D. Maksymalnie 600 znaków.

Określ typ generacji siatki 3D.

Dostępne wartości:

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

ID modelu do użycia. Dostępne wartości zależą od model_type.

Standardowe generowanie (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 topologia, nienatywnie oddzielone części, wyjście trójkątów i liczba twarzy, którą można ustawić za pomocą target_polycount.

Włącza generację Ultra dla geometrii o wyższej wierności z bardziej szczegółową powierzchnią. Generacja trwa dłużej i dodaje 5 kredytów.

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

Docelowa liczba wielokątów (twarzy) w wyniku. Rzeczywista liczba może się różnić od celu w zależności od geometrii.

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

• Remesh — z should_remesh: true na modelu standard. Siatka zostanie ponownie wygenerowana (zdekomponowana) do około tej liczby. Zakres od 100 do 300 000, domyślnie 30 000. Jeśli jest ustawiony decimation_mode, ma on priorytet, a target_polycount jest ignorowane.
• Smart Topology — z model_type: smart-topology i ai_model: meshy-t2. Model jest generowany bezpośrednio przy tej liczbie twarzy; nie ma uruchamiania 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 generacji 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 generacji.

Określ tryb pozy dla generowanego modelu.

Dostępne wartości:

• a-pose: Wygeneruj model w pozie A.
• t-pose: Wygeneruj model w pozie T.
• "" (pusty ciąg): Nie stosuje się konkretnej pozy.

Używaj pose_mode. Czy wygenerować model w pozie A/T.

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

Gdy ustawione na true, treść wejściowa będzie automatycznie przeszukiwana pod kątem potencjalnie szkodliwej treści. Jeśli wykryta zostanie szkodliwa treść, zadanie nie przejdzie do generacji.

Tekst z prompt zostanie przeszukany.

Określa, które formaty plików 3D mają być uwzględnione w wyniku. Tylko żądane formaty zostaną wygenerowane i zwrócone, co może skrócić czas realizacji zadania. Gdy pominie się, wszystkie wspierane formaty są uwzględniane.

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

Gdy ustawione na true, serwis używa wizji AI, aby automatycznie oszacować rzeczywistą wysokość obiektu i odpowiednio zmienić rozmiar modelu. Punkt początkowy zostanie domyślnie ustawiony na bottom, chyba że origin_at zostanie explicytne ustawiony.

Żądanie było nieakceptowalne. Częste przyczyny:

• Brakujący parametr: Brak wymagany parametr (np. prompt, mode).
• Nieprawidłowy parametr: art_style nie jest jednym 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.

Przekroczyłeś swój limit szybkości.

To pole powinno być ustawione na "refine", gdy tworzymy zadanie ulepszenia.

Odpowiadający identyfikator zadania podglądu.

Status podanego zadania podglądu musi być SUCCEEDED.

Generuj mapy PBR (metalliczne, szorstkość, normalność) oprócz podstawowego koloru. Mapa emisji jest również dołączona, gdy ai_model jest meshy-6, z wyjątkiem texture_resolution: 8k (nie jest produkowana mapa emisji). meshy-7 (i latest) nie produkuje mapy emisji.

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

Użyj texture_resolution zamiast tego — równoważne z texture_resolution: "4k". Jeśli oba są ustawione, texture_resolution ma pierwszeństwo.

Podaj dodatkowy tekstowy prompt w celu kierowania procesem teksturowania. Maksymalnie 600 znaków.

Podaj dwuwymiarowy obrazek, aby kierować procesem teksturowania. Aktualnie obsługujemy formaty .jpg, .jpeg i .png.

Istnieją dwa sposoby na dostarczenie obrazu:

• Publicznie dostępny URL: URL, który jest dostępny z publicznego internetu
• Data URI: Bazowy kodowany URI danych obrazu. Przykład URI danych: data:image/jpeg;base64,<twoje bazowe kodowane dane obrazowe>

ID modelu do użycia w celu ulepszenia. Dostępne wartości: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

Gdy ustawione na true, treść wejściowa będzie automatycznie przeszukiwana pod kątem potencjalnie szkodliwych treści. Jeśli wykryta zostanie szkodliwa treść, zadanie nie przejdzie do generacji.

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

Usuwa światła i cienie z tekstury podstawowego koloru, generując czystszy wynik, który lepiej działa w niestandardowych ustawieniach oświetlenia.

Określa, które formaty plików 3D mają być uwzględnione w wyniku. Tylko żądane formaty zostaną wygenerowane i zwrócone, co może skrócić czas realizacji zadania. Gdy pominie się, wszystkie wspierane formaty są uwzględniane.

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

Gdy ustawione na true, serwis używa wizji AI, aby automatycznie oszacować rzeczywistą wysokość obiektu i odpowiednio zmienić rozmiar modelu. Punkt początkowy zostanie domyślnie ustawiony na bottom, chyba że origin_at zostanie explicytne ustawiony.

Żądanie było nieakceptowalne. Częste przyczyny:

• Nieprawidłowy identyfikator zadania: preview_task_id jest nieprawidłowy lub nie istnieje.
• Zadanie nie jest gotowe: Zadanie podglądu nie zostało jeszcze zakończone sukcesem.
• Niewłaściwe modele: Model AI zadania podglądu jest niekompatybilny z żądanym modelem ulepszenia.

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

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

Żądane zadanie podglądu określone przez preview_task_id nie zostało znalezione.

Przekroczyłeś swój limit szybkości.

Unikalny identyfikator zadania Tekst na 3D do pobrania.

ID zadania Tekst na 3D do usunięcia.

Numer strony dla stronicowania.

Limit rozmiaru strony. Maksymalnie dozwolone jest 50 pozycji.

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 zadania Tekst na 3D do strumieniowania.

Unikalny identyfikator zadania. Chociaż używamy k-sortowalnego UUID dla identyfikatorów zadań jako szczegóły implementacji, nie powinieneś wysnuwać żadnych założeń odnośnie 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 ulepszenia.

Może być pobrany URL do wygenerowanego przez Meshy pliku modelu 3D z teksturą. Właściwość dla formatu będzie pominięta, jeśli format nie został wygenerowany, zamiast zwracania pustego ciągu.

To jest niezmieniony prompt, który został użyty do utworzenia zadania.

Utrzymane dla kompatybilności wstecznej. To pole nie ma funkcjonalnego wpływu na generowane modele.

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

Utrzymane dla kompatybilności wstecznej. To pole nie ma funkcjonalnego wpływu na generowane modele.

Dodatkowy tekstowy prompt dostarczony do kierowania procesem teksturowania na etapie ulepszenia.

Odtwarza wartość ultra_mode, za którą zostało utworzone zadanie podglądu. Obecne tylko dla zadań podglądu meshy-7 (lub latest), które explicytne ustawiły ultra_mode; pominięte w przeciwnym razie.

Może być pobrany URL do obrazu teksturowego, używanego do kierowania procesem teksturowania.

Może być pobrany URL do obrazu miniatury pliku modelu.

Może być pobrany URL do 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 renderowany; w przeciwnym razie to pole jest pominięte.

Może być pobrany URL do filmu podglądowego. Zostanie usunięte w przyszłej wersji.

Postęp zadania. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość będzie 0. Gdy zadanie zakończy się sukcesem, stanie się 100.

Znacznik czasu rozpoczęcia zadania, w milisekundach. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość będzie 0.

Znacznik czasu utworzenia zadania, w milisekundach.

Znacznik czasu zakończenia zadania, w milisekundach. Jeśli zadanie jeszcze nie zakończyło się, ta właściwość będzie 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 poprzednich zadań.

Szczegóły błędu dla zadań niepowodzenia. 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 przy niepowodzeniu).