Auto Split API

ID zakończonego powodzeniem zadania, którego model ma zostać podzielony. Obsługiwane typy zadań: Obraz na 3D, Wiele obrazów na 3D, Tekst na 3D (podgląd), Remesh, Konwertuj oraz Zmień rozmiar. Zadanie musi mieć status SUCCEEDED, a jego model musi być wygenerowany za pomocą Meshy 6 lub Meshy 7 (ai_model meshy-6, meshy-7 lub latest). Modele low-poly oraz Smart Topology (meshy-t2) nie są obsługiwane.

Sposób podziału modelu na części.

Dostępne wartości:

• auto: Meshy samodzielnie wybiera miejsca cięć. prompt jest ignorowany.
• by_parts: Cięcie wzdłuż nazwanych w prompt części strukturalnych, takich jak głowa, ramiona i tułów.
• by_color: Cięcie wzdłuż obszarów kolorystycznych nazwanych w prompt. Wymaga danych wejściowych wygenerowanych na podstawie przesłanego obrazu (Obraz na 3D lub Wiele obrazów na 3D); inne dane wejściowe są odrzucane z kodem 400.

Formaty, w jakich ma zostać wyeksportowany podzielony model. Każda część jest osobnym obiektem w każdym formacie. glb jest zawsze generowany i zwracany w model_urls; wymień dodatkowo dowolne inne formaty, których potrzebujesz.

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

3mf jest zapisywany z myślą o slicerach: jeden obiekt na część, każdy na własnym slocie filamentu, dzięki czemu Bambu Studio otwiera plik jako indywidualnie kolorowane, oddzielnie zaznaczalne części (archiwum zawiera konfigurację projektu Bambu Studio; inne slicery odczytują samą geometrię). Podobnie jak inne formaty wydruku w Meshy, jest on wyrażony w milimetrach i ponieważ ten punkt końcowy nie przyjmuje docelowego rozmiaru, cały model jest skalowany tak, aby jego najdłuższy bok wynosił 150 mm — taki sam limit stosowany jest w eksportach do pozostałych formatów wydruku, dobrany tak, aby zmieścić się na każdym typowym stole roboczym. Przy layout: "on_plate" limit odnosi się do całego rozłożonego stołu, dzięki czemu plik jest gotowy do cięcia na warstwy; przy assembled części pozostają w położeniu, jakie miały w modelu źródłowym, i to Ty rozmieszczasz je w slicerze.

Sposób rozmieszczenia części w każdym formacie wyjściowym oraz na miniaturze.

Dostępne wartości:

• assembled: Części pozostają w położeniu, jakie miały w modelu źródłowym.
• on_plate: Części są ułożone płasko i rozłożone na stole roboczym, gotowe do cięcia na warstwy — tak samo jak w widoku On Plate w aplikacji webowej.

W obu układach eksportowane pliki zawierają jeden obiekt na część i nic poza tym: zapadnięty fragment lub przypominająca punkt resztka pozostała po cięciu jest usuwana przed eksportem, więc każdy obiekt znaleziony w pliku nadaje się do druku.

Dodaje łączniki typu czop-gniazdo w każdym miejscu cięcia, aby wydrukowane części do siebie pasowały.

Żądanie było nieprawidłowe. Typowe przyczyny:

• Brak promptu: prompt jest wymagany, gdy mode ma wartość by_parts lub by_color.
• Prompt nazywa mniej niż dwie części: by_parts / by_color wymaga co najmniej dwóch nazwanych elementów (na przykład głowa, tułów, podstawa); ogólne polecenie, takie jak podziel na poszczególne części, jest odrzucane. Nic nie jest naliczane.
• Nieobsługiwane zadanie wejściowe: input_task_id musi wskazywać zakończone powodzeniem zadanie obsługiwanego typu, wygenerowane za pomocą Meshy 6 lub Meshy 7.
• Teksturowane dane wejściowe: Model wejściowy zawiera tekstury. Na razie obsługiwane są tylko modele bez tekstur.
• Brak obrazu referencyjnego: by_color wymaga danych wejściowych wygenerowanych na podstawie przesłanego obrazu.
• Nieobsługiwany format: target_formats zawiera stl.
• Łącznik poza zakresem: connector_size lub connector_height znajduje się poza zakresem od 0.1 do 0.8.

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

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

input_task_id nie istnieje lub nie należy do Twojego konta.

Przekroczono limit szybkości. Żądania by_parts i by_color mają wspólny limit analizy promptu wynoszący 12 żądań na minutę na konto.

Podział oparty na promptach (by_parts i by_color) jest tymczasowo niedostępny. Spróbuj ponownie później lub użyj mode: "auto", na który to ograniczenie nie ma wpływu. Nic nie jest naliczane.

ID zadania Auto Split, które ma zostać pobrane.

ID zadania Auto Split do usunięcia.

Numer strony na potrzeby stronicowania. Zaczyna się od 1 i domyślnie ma tę wartość.

Limit rozmiaru strony. Domyślnie 10 elementów. Maksymalna dozwolona wartość to 100 elementów; większe wartości są ograniczane do 100.

Pole, według którego ma nastąpić sortowanie. Dostępne wartości:

• +created_at: Sortowanie według czasu utworzenia w kolejności rosnącej.
• -created_at: Sortowanie według czasu utworzenia w kolejności malejącej.

Unikalny identyfikator zadania Auto Split, które ma być strumieniowane.

Unikalny identyfikator zadania. Choć jako szczegół implementacyjny używamy dla identyfikatorów zadań UUID z możliwością sortowania po kluczu (k-sortable), nie należy zakładać niczego co do formatu tego identyfikatora.

Typ zadania. Wartość to print-split.

Adresy URL do pobrania podzielonego modelu, po jednym dla każdego żądanego formatu. Każda część jest osobnym obiektem w pliku. Właściwość dla danego formatu zostanie pominięta, jeśli ten format nie został zażądany.

Adres URL do pobrania renderowanego podglądu podzielonego modelu, z każdą częścią w odrębnym kolorze, w żądanym layout.

true, gdy prompt żądania by_parts lub by_color nie wskazywał żadnych części, więc Meshy podzieliło model automatycznie — nazwy części w wyniku pochodzą od Meshy, a nie od Ciebie. Obecne od statusu PENDING. Pomijane dla zadań auto oraz zawsze wtedy, gdy prompt został uwzględniony.

Liczba drukowalnych części w podzielonym modelu — jedna na obiekt w eksportowanych plikach. Zapadnięte odłamki, których segmentacja nie mogła przekształcić w drukowalną część, są usuwane z plików przed eksportem i nie są liczone.

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

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

Liczba poprzedzających zadań.

Znacznik czasu utworzenia zadania, w milisekundach.

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

Znacznik czasu zakończenia zadania, w milisekundach. Jeśli zadanie jeszcze się nie zakończyło, ta właściwość będzie miała wartość 0.

Szczegóły błędu dla nieudanych zadań. Pełny opis obiektu task_error znajduje się w Błędy.

Liczba kredytów zużytych przez to zadanie. Zawsze obecne: 10 po przyjęciu zadania oraz 0 dla zadań FAILED, ponieważ opłata jest zwracana w przypadku niepowodzenia. Usunięcie zadania, gdy nadal ma status PENDING, również powoduje zwrot.