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 i Zmień rozmiar. Zadanie musi mieć status SUCCEEDED, a jego model musi zostać wygenerowany za pomocą Meshy 6 lub Meshy 7 (ai_model meshy-6, meshy-7 lub latest). Modele low-poly i Smart Topology (meshy-t2) nie są obsługiwane.

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

Dostępne wartości:

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

Formaty, w jakich ma zostać wyeksportowany podzielony model. W każdym formacie każda część stanowi osobny obiekt. Format glb jest zawsze generowany i zwracany w model_urls; podaj dodatkowo dowolne inne formaty, które chcesz otrzymać.

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

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

Dostępne wartości:

• assembled: Części pozostają w miejscach, w których znajdowały się w modelu źródłowym.
• on_plate: Części są ułożone płasko i rozmieszczone na płycie roboczej, gotowe do cięcia na warstwy — tak samo jak w widoku On Plate w aplikacji webowej.

W obu układach eksportowane pliki zawierają po jednym obiekcie na każdą część i nic więcej: zredukowany do cienkiej warstwy lub punktowy fragment pozostały po cięciu jest usuwany przed eksportem, dzięki czemu każdy obiekt znaleziony w pliku nadaje się do druku.

Dodaje łączniki typu wpust-czop przy każdym cięciu, dzięki czemu wydrukowane części pasują do siebie.

Żądanie było nieprawidłowe. Najczęstsze przyczyny:

• Brak prompt: prompt jest wymagany, gdy mode ma wartość by_parts lub by_color.
• Prompt nazywa mniej niż dwie części: by_parts / by_color wymaga podania co najmniej dwóch nazwanych elementów (na przykład głowa, tułów, podstawa); ogólne polecenie, takie jak podziel na pojedyncze części, jest odrzucane. Nic nie jest naliczane.
• Nieobsługiwane zadanie wejściowe: input_task_id musi wskazywać na zakończone powodzeniem zadanie obsługiwanego typu, wygenerowane za pomocą Meshy 6 lub Meshy 7.
• Teksturowane dane wejściowe: Model wejściowy ma tekstury. Obecnie obsługiwane są tylko modele bez tekstur.
• Brak obrazu referencyjnego: by_color wymaga danych wejściowych wygenerowanych z 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 do wykonania tego zadania.

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

Przekroczono limit szybkości. Żądania by_parts i by_color współdzielą również limit parsowania promptów wynoszący 12 żądań na minutę na konto.

Podział na podstawie promptu (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 identyfikatorów zadań w formacie k-sortable UUID, nie należy przyjmować żadnych założeń co do formatu identyfikatora.

Typ zadania. Wartością jest 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 format nie został zażądany.

Adres URL do pobrania renderowanego podglądu podzielonego modelu, gdzie każda część ma odrębny kolor, w zadanym layout.

true, gdy prompt w żądaniu 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 użytkownika. Obecne od statusu PENDING. Pomijane dla zadań auto oraz zawsze, gdy prompt został zastosowany.

Liczba drukowalnych części w podzielonym modelu — po jednej na każdy obiekt w wyeksportowanych plikach. Zapadnięte, niewielkie fragmenty, których segmentacja nie mogła przekształcić w drukowalny element, są usuwane z plików przed eksportem i nie są liczone.

Postęp zadania (progress). Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość będzie miała wartość 0. Gdy zadanie zakończy się sukcesem, wartość ta zmieni się na 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 kredytów.