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, meshy-7.1 lub latest). Modele low-poly oraz Smart Topology (meshy-t2) 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 samodzielnie wybiera miejsca cięć. prompt jest ignorowany.
• by_parts: Cięcie wzdłuż strukturalnych części nazwanych w prompt, takich jak głowa, ręce i tułów.
• by_color: Cięcie 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 używa 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 (aby uzyskać osobno wybieralne części w slicerze, poproś o 3mf). glb jest zawsze generowany i zwracany w model_urls; wymień dodatkowo dowolne 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ą rozłożone płasko i rozmieszczone na stole roboczym, gotowe do cięcia w slicerze — tak samo jak w widoku On Plate aplikacji webowej.

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

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

Żądanie było niepoprawne. Typowe przyczyny:

• Brak promptu: prompt jest wymagany, gdy mode ma wartość by_parts lub by_color.
• Prompt nie opisuje podziału albo opisuje zbyt wiele części: by_parts / by_color akceptuje od 1 do 10 nazwanych fragmentów. Opis, który prosi o pozostawienie modelu w jednym kawałku, lub nazywa więcej niż 10 części, jest odrzucany. Nic nie zostaje naliczone.
• 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 analizy 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", który nie jest tym dotknięty. Nic nie zostaje naliczone.

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

ID zadania Auto Split do usunięcia.

Numer strony do 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 być sortowane. Dostępne wartości:

• +created_at: Sortowanie według czasu utworzenia rosnąco.
• -created_at: Sortowanie według czasu utworzenia malejąco.

Unikalny identyfikator zadania Auto Split, które ma być przesyłane strumieniowo.

Unikalny identyfikator zadania. Choć jako szczegół implementacyjny używamy dla identyfikatorów zadań UUID z możliwością sortowania k, nie powinieneś przyjmować żadnych założeń co do formatu identyfikatora.

Typ zadania. Wartość to print-split.

Adresy URL do pobrania podzielonego modelu, jeden dla każdego żądanego formatu. Formaty obsługujące obiekty scen zachowują każdą część jako osobny obiekt; stl scala je w jedno jednolite ciało. Właściwość dla formatu zostanie pominięta, jeśli format nie był żą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 wskazał żadnych części, więc Meshy podzieliło model automatycznie — nazwy części w wyniku pochodzą od Meshy, nie od Ciebie. Obecne od PENDING. Pomijane dla zadań auto oraz gdy prompt został uwzględniony.

Liczba drukowalnych części wygenerowanych przez podział. Formaty obsługujące obiekty scen zawierają jeden obiekt na część; stl scala je w jedno jednolite ciało, a liczba wciąż odnosi się do liczby części. Zapadnięte fragmenty, które segmentacja nie zdołała przekształcić w drukowalny element, są usuwane z plików przed eksportem i nie są liczone.

Progress zadania. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość ma 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 nie zostało jeszcze rozpoczęte, ta właściwość ma wartość 0.

Znacznik czasu zakończenia zadania, w milisekundach. Jeśli zadanie nie zostało jeszcze zakończone, ta właściwość ma wartość 0.

Szczegóły błędu dla zadań zakończonych niepowodzeniem. Zobacz Błędy, aby uzyskać pełny opis obiektu task_error.

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