Auto Split API

ID zadania, którego model ma zostać podzielony. Zadanie musi mieć status SUCCEEDED. Działają następujące typy zadań:

• Obraz na 3D
• Wiele obrazów na 3D
• Tekst na 3D, zadanie preview lub refine
• Reteksturowanie
• Remesh
• Konwertuj
• Zmień rozmiar

Model musi zostać wygenerowany za pomocą Meshy 6 lub Meshy 7, czyli z ai_model ustawionym na meshy-6-lite, meshy-6, meshy-7, meshy-7.1 lub latest. Modele Smart Topology (meshy-t2 i meshy-t2.5) nie są obsługiwane. W przypadku zadania refine, Reteksturowania, Remesh, Konwertuj lub Zmień rozmiar reguła dotyczy modelu, od którego zadanie się rozpoczęło. Zadanie Reteksturowanie, Remesh, Konwertuj lub Zmień rozmiar utworzone na podstawie przesłanego modelu zwraca 400.

Model może mieć maksymalnie 8 000 000 ścianek. Model z większą liczbą ścianek zwraca 400. W takim przypadku najpierw uruchom na nim zadanie Remesh i wyślij ID zadania Remesh zamiast tego.

Możesz podzielić model z teksturą. Aby zachować jego teksturę na częściach, wyślij keep_texture: true.

Jak podzielić model na części.

Dostępne wartości:

• auto: Meshy samo wybiera cięcia i ignoruje prompt. Prompt dłuższy niż 600 znaków nadal zwraca 400.
• by_parts: Meshy tnie wzdłuż części strukturalnych, które nazwiesz w prompt, na przykład głowa, ramiona i tułów.
• by_color: Meshy tnie wzdłuż obszarów kolorystycznych, które nazwiesz w prompt. Meshy znajduje te obszary w obrazie źródłowym, a nie w teksturze modelu wejściowego. Dane wejściowe muszą być wygenerowane z przesłanego obrazu, za pomocą Obraz na 3D lub Wiele obrazów na 3D. Inne dane wejściowe zwracają 400. W przypadku Wiele obrazów na 3D Meshy używa pierwszego obrazu źródłowego.

Formaty plików do wygenerowania. Meshy zawsze generuje glb i zwraca go w model_urls, a dodatkowo pozostałe wymienione przez Ciebie formaty.

Dostępne wartości:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Każdy format oprócz stl obsługuje obiekty sceny i przechowuje każdą część jako osobny obiekt. Plik STL nie może zawierać oddzielnych obiektów, więc Meshy łączy części w jedną bryłę, ułożoną zgodnie z layout. Aby uzyskać części, które można zaznaczać osobno w slicerze, zażądaj 3mf.

Przy keep_texture: true te formaty przechowują teksturę:

• glb, fbx, usdz i blend: Tekstura znajduje się w pliku.
• obj: Tekstura znajduje się w pliku materiału, który model_urls zwraca pod mtl.
• stl i 3mf: Plik zawiera tylko geometrię, bez tekstury.

Jak Meshy rozmieszcza części, w każdym formacie pliku i na miniaturze.

Dostępne wartości:

• assembled: Meshy zachowuje części tam, gdzie znajdowały się w modelu źródłowym.
• on_plate: Meshy układa części płasko i rozmieszcza je na platformie roboczej, gotowe do cięcia na warstwy. Jest to taki sam układ jak widok On Plate w aplikacji webowej.

W obu układach Meshy usuwa przed eksportem każdy zapadnięty, cienki jak papier lub przypominający punkt fragment pozostawiony przez cięcie, dzięki czemu każda otrzymana część nadaje się do druku. Formaty obsługujące obiekty sceny przechowują jeden obiekt na część, a stl łączy części w jedną bryłę.

Czy zachować teksturę modelu wejściowego na częściach. true nadaje każdej części teksturę modelu wejściowego, a zadanie zwraca mapy w texture_urls. false nadaje każdej części jednolity kolor wierzchołków.

Przy true zadanie trwa około dwa razy dłużej, a koszt w kredytach się nie zmienia. Model bez tekstury jest dzielony tak samo jak przy false. Jeśli Meshy nie może zachować tekstury, zadanie kończy się niepowodzeniem z kodem błędu textured_split_refused. Zobacz Błędy.

Czy dodać łączniki typu czop i gniazdo przy każdym cięciu, aby wydrukowane części do siebie pasowały.

Żądanie nie może zostać wykonane. Komunikat o błędzie wskazuje, jaki problem wykryto. Na przykład:

• Brak promptu: mode to by_parts lub by_color, a prompt jest nieobecny.
• Prompt nie opisuje podziału lub zawiera zbyt wiele części: Prompt prosi o pozostawienie modelu w jednym kawałku lub nazywa więcej niż 10 części. by_parts i by_color akceptują od 1 do 10 nazwanych części. Meshy nie nalicza opłaty za to żądanie.
• Nieobsługiwane zadanie wejściowe: input_task_id nie jest zakończonym powodzeniem zadaniem obsługiwanego typu, wygenerowanym za pomocą Meshy 6 lub Meshy 7.
• Brak obrazu referencyjnego: mode to by_color, a dane wejściowe nie zostały wygenerowane z przesłanego obrazu.
• Łącznik poza zakresem: connector_size lub connector_height znajduje się poza zakresem od 0.1 do 0.8.

Popraw żądanie, a następnie wyślij je ponownie. Zobacz Błędy.

Brak klucza API lub klucz jest nieprawidłowy. Sprawdź nagłówek Authorization.

Na przykład:

• Niewystarczające kredyty: Konto nie ma wystarczającej liczby kredytów na to zadanie lub konto osiągnęło limit kredytów. Sprawdź saldo kredytów, a następnie spróbuj ponownie.
• Plan darmowy: Utworzenie zadania wymaga płatnego planu. Uaktualnij swój plan w ustawieniach subskrypcji, a następnie spróbuj ponownie.

Zastosowanie ma jedna z poniższych sytuacji:

• Moderacja treści zablokowała prompt. Komunikat to explicit content lub prohibited content. Zmień prompt, a następnie spróbuj ponownie.
• input_task_id to model płaskorzeźby, którego ten punkt końcowy nie może podzielić. Komunikat to This model type does not support this operation. Wyślij inny model.

input_task_id nie istnieje lub nie należy do Twojego konta. Sprawdź ID i użyj klucza API z konta, które utworzyło zadanie.

Przekroczono limit szybkości. Poczekaj, a następnie spróbuj ponownie. Zobacz Limity szybkości.

Żądania by_parts i by_color dzielą również limit odczytu promptów wynoszący 12 żądań na minutę na konto.

Dzielenie na podstawie promptu (by_parts i by_color) jest tymczasowo niedostępne. Spróbuj ponownie później lub wyślij mode: "auto", co nadal działa. Meshy nie nalicza opłaty za to żądanie.

ID zadania z odpowiedzi tworzącej zadanie.

ID zadania do usunięcia.

Numer strony do zwrócenia. Zaczyna się od i domyślnie wynosi 1.

Liczba zadań na stronę, do 100. Domyślnie 10. Meshy traktuje większą wartość jako 100.

Kolejność sortowania.

Dostępne wartości:

• +created_at: najstarsze najpierw
• -created_at: najnowsze najpierw

ID zadania z odpowiedzi tworzącej zadanie.

ID zadania. Traktuj je jako nieprzezroczysty ciąg znaków i nie polegaj na jego formacie.

Typ zadania, zawsze print-split.

Adresy URL do pobrania podzielonego modelu, po jednym na każdy żądany format. Format, którego nie żądano, nie ma odpowiadającego mu klucza. Formaty obsługujące obiekty sceny zachowują każdą część jako osobny obiekt, a stl łączy części w jedną bryłę.

Adres URL do pobrania obrazu podglądu podzielonego modelu, w żądanym layout. Gdy części zachowują teksturę, podgląd ją pokazuje. W przeciwnym razie każda część ma swój własny kolor.

Mapy tekstur podzielonego modelu, jako tablica z jednym obiektem. Wszystkie części współdzielą te mapy. Obecne tylko, gdy keep_texture ma wartość true, a model wejściowy posiada teksturę.

Adres URL do pobrania wersji thumbnail_url z przezroczystym tłem (RGBA). Obecny tylko po pomyślnym zakończeniu zadania, gdy Meshy wyrenderowało przezroczysty podgląd.

Czy Meshy zignorowało prompt. Ma wartość true, gdy prompt żądania by_parts lub by_color nie wskazał żadnych części, więc Meshy podzieliło model automatycznie. Nazwy części w wyniku pochodzą wtedy od Meshy, a nie od Ciebie. Obecne od statusu PENDING. Meshy pomija to pole w zadaniach auto oraz zawsze, gdy zastosowało się do promptu.

Liczba części nadających się do druku, które powstały w wyniku podziału. Formaty obsługujące obiekty sceny zawierają jeden obiekt na część. stl łączy części w jedną bryłę, ale part_count nadal je liczy. Przed eksportem Meshy usuwa zapadnięte fragmenty, które nie mogą stać się częścią nadającą się do druku, i ich nie liczy.

Jak dużo z zadania zostało wykonane, w procentach. Wynosi 0, dopóki zadanie się nie rozpocznie, i 100, gdy zakończy się powodzeniem.

Status zadania, jeden z: PENDING, IN_PROGRESS, SUCCEEDED, FAILED lub CANCELED.

Liczba zadań znajdujących się przed tym zadaniem w kolejce. Wartość ma znaczenie tylko wtedy, gdy zadanie ma status PENDING.

Czas utworzenia zadania, w milisekundach Unix.

Czas rozpoczęcia zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie rozpocznie.

Czas zakończenia zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie zakończy.

Czas wygaśnięcia wyniku zadania, w milisekundach Unix. Wynosi 0, dopóki zadanie się nie zakończy.

Szczegóły błędu, gdy zadanie zakończy się niepowodzeniem. Zobacz Błędy.

Jeśli kontrola bezpieczeństwa odrzuci model wejściowy, zadanie zakończy się niepowodzeniem z task_error.type ustawionym na invalid_input i task_error.code ustawionym na provider_content_refused. Prześlij inny model. Zobacz Błędy.

Przy keep_texture: true, jeśli Meshy nie może zachować tekstury, zadanie zakończy się niepowodzeniem z task_error.code ustawionym na textured_split_refused. Zobacz Błędy.

Liczba kredytów zużytych przez zadanie. Jest zawsze obecna. Wynosi 10 po zaakceptowaniu zadania przez Meshy i 0 dla zadania ze statusem FAILED, ponieważ Meshy zwraca kredyty, gdy zadanie zakończy się niepowodzeniem. Usunięcie zadania ze statusem PENDING również powoduje zwrot kredytów.