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 (wersja wstępna), Remesh, Konwertuj oraz 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, meshy-7.1 lub latest). Modele low-poly i Smart Topology (meshy-t2, meshy-t2.5) nie są obsługiwane. Model z teksturą jest akceptowany, ale jego tekstura nie jest przenoszona do wyniku.

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

Dostępne wartości:

• auto: Meshy samo wybiera cięcia. prompt jest ignorowany.
• by_parts: Tnij wzdłuż części strukturalnych nazwanych w prompt, takich jak głowa, ręce i tułów.
• by_color: Tnij wzdłuż obszarów kolorystycznych nazwanych w prompt. Wymaga danych wejściowych wygenerowanych z przesłanego obrazu (Obraz na 3D lub Wiele obrazów na 3D); inne dane wejściowe są odrzucane z kodem 400. Granice obszarów kolorystycznych pochodzą z obrazu źródłowego, a nie z tekstury modelu wejściowego. W przypadku Wiele obrazów na 3D, Auto Split korzysta z pierwszego obrazu źródłowego.

Formaty, w jakich ma zostać wyeksportowany podzielony model. Formaty obsługujące obiekty sceny (glb, obj, fbx, usdz, blend, 3mf) przenoszą każdą część jako osobny obiekt; stl nie ma pojęcia osobnych obiektów, więc łączy każdą część w jedną bryłę ułożoną zgodnie z layout (jeśli potrzebujesz osobno zaznaczalnych części w slicerze, zażądaj 3mf). glb jest zawsze generowany i zwracany w model_urls; wymień dodatkowo wszystkie inne formaty, których potrzebujesz.

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

Sposób ułożenia części w każdym formacie wyjściowym oraz na miniaturze.

Dostępne wartości:

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

W obu układach przed eksportem usuwany jest zapadnięty skrawek lub fragment przypominający punkt, pozostały po cięciu, dzięki czemu każda uzyskana część jest drukowalna. Formaty obsługujące obiekty sceny zawierają jeden obiekt na część; stl łączy je w jedną bryłę.

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

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

• Brakujący prompt: prompt jest wymagany, gdy mode to by_parts lub by_color.
• Prompt nie opisuje żadnego podziału lub podaje zbyt wiele części: by_parts / by_color akceptuje od 1 do 10 nazwanych elementów. Opis, który prosi o pozostawienie modelu w jednej części lub nazywa więcej niż 10 części, jest odrzucany. Nic nie jest naliczane.
• Nieobsługiwane zadanie wejściowe: input_task_id musi odnosić się do zakończonego powodzeniem zadania obsługiwanego typu, wygenerowanego za pomocą Meshy 6 lub Meshy 7.
• Brak obrazu referencyjnego: by_color wymaga danych wejściowych wygenerowanych z przesłanego obrazu.
• Łą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 dzielą również limit parsowania promptów wynoszący 12 żądań na minutę na konto.

Dzielenie oparte na promptach (by_parts i by_color) jest tymczasowo niedostępne. Spróbuj ponownie później lub użyj mode: "auto", na który ta sytuacja 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ę i domyślnie wynosi 1.

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 odbywać się 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ć przesyłane strumieniowo.

Unikalny identyfikator zadania. Mimo że jako szczegół implementacyjny używamy identyfikatorów zadań w formacie k-sortable UUID, nie należy przyjmować żadnych założeń co do formatu id.

Typ zadania. Wartość to print-split.

Adresy URL do pobrania podzielonego modelu, po jednym dla każdego żądanego formatu. Formaty obsługujące obiekty sceny zachowują każdą część jako osobny obiekt; stl łączy je w jedną bryłę. Właściwość dla danego formatu zostanie pominięta, jeśli format nie był żądany.

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

true, gdy prompt w żądaniu by_parts lub by_color nie wskazywał nazw żadnych części, przez co 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ł zastosowany.

Liczba drukowalnych części uzyskanych w wyniku podziału. Formaty obsługujące obiekty sceny zawierają jeden obiekt na część; stl łączy je w jedną bryłę, ale liczba nadal odnosi się do liczby części. Zapadnięte fragmenty, których segmentacja nie mogła przekształcić w drukowalny element, są usuwane z plików przed eksportem i nie są wliczane do tej liczby.

Postęp zadania. Jeśli zadanie jeszcze się nie rozpoczęło, ta właściwość przyjmuje wartość 0. Gdy zadanie zakończy się powodzeniem, 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ść przyjmuje wartość 0.

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

Szczegóły błędu dla nieudanych zadań. Pełny opis obiektu task_error znajdziesz w sekcji Błędy. Jeśli kontrola bezpieczeństwa dostawcy modelu odrzuci model wejściowy, zadanie kończy się niepowodzeniem z task_error.type ustawionym na invalid_input i code ustawionym na provider_content_refused. Zobacz Błędy.

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