Remesh API

ID ukończonego zadania Obraz na 3D lub Tekst na 3D, które chcesz poddać remesh. Zadanie to musi być jednym z poniższych: Tekst na 3D Preview, Tekst na 3D Refine, Obraz na 3D lub Reteksturowanie. Dodatkowo musi mieć status SUCCEEDED.

Podaj model 3D, który Meshy ma poddać remesh, za pomocą publicznie dostępnego adresu URL lub identyfikatora data URI. Obsługiwane formaty: .glb, .gltf, .obj, .fbx, .stl.

W przypadku Data URI użyj typu MIME: application/octet-stream.

Maksymalny rozmiar pliku: 400 MB dla adresu URL typu http lub https, 100 MB dla identyfikatora data:.

Plik GLB, glTF, FBX lub OBJ większy niż 100 MB może mieć maksymalnie 10 000 000 ścian. Ściany są liczone jako trójkąty: czworokąt liczy się jako 2, a siatka narysowana więcej niż raz liczy się raz na każdą kopię. Powyżej 100 MB plik FBX musi być binarnym FBX w wersji 7.1 lub nowszej, a plik GLB lub glTF nie może używać kompresji Draco.

Lista formatów docelowych dla modelu po remesh. Jeśli pominięto, generowany jest tylko format GLB.

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

Określa topology wygenerowanego modelu.

Dostępne wartości:

• quad: Generuje siatkę z przewagą czworokątów.
• triangle: Generuje zdecymowaną siatkę trójkątną.

Określa docelową liczbę wielokątów w wygenerowanym modelu. Rzeczywista liczba wielokątów może odbiegać od wartości docelowej w zależności od złożoności geometrii.

Prawidłowy zakres to od 100 do 300 000 (włącznie).

Włącza adaptacyjną decymację poprzez ustawienie poziomu liczby wielokątów. Gdy ta wartość jest ustawiona, target_polycount jest ignorowane.

Dostępne wartości:

• 1: Adaptacyjna — bardzo duża liczba wielokątów.
• 2: Adaptacyjna — duża liczba wielokątów.
• 3: Adaptacyjna — średnia liczba wielokątów.
• 4: Adaptacyjna — mała liczba wielokątów.

Zmienia rozmiar modelu do określonej wysokości mierzonej w metrach. Zalecamy korzystanie z dedykowanego Resize API.

Zmienia rozmiar modelu tak, aby najdłuższy wymiar jego bounding-box był równy podanej wartości w metrach. Zalecamy korzystanie z dedykowanego Resize API.

Gdy ustawione na true, usługa wykorzystuje wizję AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniego dostosowania rozmiaru modelu. Zalecamy korzystanie z dedykowanego Resize API.

Jeśli true, usługa zmieni jedynie format pliku modelu wejściowego, ignorując inne dane wejściowe, takie jak topology, resize_height i target_polycount. Zalecamy korzystanie z dedykowanego Convert API.

Gdy ustawione na true, zadanie dodatkowo renderuje wersję podglądu z przezroczystym tłem (RGBA) i zwraca ją jako alpha_thumbnail_url w odpowiedzi GET. Istniejące pole thumbnail_url pozostaje bez zmian.

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

• Brakujący parametr: Należy podać model_url lub input_task_id.
• Nieprawidłowe zadanie wejściowe: input_task_id musi odnosić się do zakończonego powodzeniem zadania z obsługiwanego modelu.
• Nieprawidłowy format modelu: model_url wskazuje plik o nieobsługiwanym rozszerzeniu.
• Niedostępny adres URL: Nie udało się pobrać pliku spod model_url.
• Plik modelu zbyt duży: Plik pod model_url przekracza 400 MB (adres URL http lub https) lub 100 MB (identyfikator data:).
• Zbyt wiele ścian: Plik pod model_url ma rozmiar powyżej 100 MB i ponad 10 000 000 ścian. Zmniejsz liczbę ścian i wyślij plik ponownie.
• ASCII FBX powyżej 100 MB: Plik pod model_url to ASCII FBX powyżej 100 MB. Wyślij go jako binarny FBX lub GLB.
• Nieodczytywalny plik modelu: Plik pod model_url ma rozmiar powyżej 100 MB, a jego nagłówka nie można odczytać, na przykład jest to GLB lub glTF skompresowany Draco, albo binarny FBX starszy niż 7.1.
• Nagłówek modelu zbyt złożony: Plik pod model_url ma rozmiar powyżej 100 MB, a jego nagłówek zawiera zbyt wiele siatek, węzłów lub rekordów do sprawdzenia. Zmniejsz liczbę obiektów w pliku i wyślij go ponownie.
• Nieprawidłowe topology: Parametr topology jest nieprawidłowy.
• Parametry wzajemnie wykluczające się: Nie można ustawić jednocześnie auto_size i resize_height.

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

Niewystarczająca liczba kredytów do wykonania tego zadania.

Przekroczono limit szybkości.

ID zadania remesh do pobrania.

ID zadania remesh, które ma zostać usunięte.

Numer strony do stronicowania.

Limit rozmiaru strony. Maksymalna dozwolona wartość to 100 elementów.

Pole, według którego ma nastąpić sortowanie.

Dostępne wartości:

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

Unikalny identyfikator zadania Remesh do strumieniowania.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy k-sortowalnego UUID dla identyfikatorów zadań, nie należy przyjmować żadnych założeń co do formatu tego identyfikatora.

Typ zadania Remesh. Wartość to remesh.

Adres URL do pobrania pliku modelu 3D z teksturami wygenerowanego przez Meshy. Właściwość dla danego formatu zostanie pominięta, jeśli dany format nie został wygenerowany, zamiast zwracać pusty ciąg znaków.

Adres URL do pobrania podglądu obrazu wyrenderowanego z modelu po remeshingu.

Adres URL do pobrania wersji thumbnail_url z przezroczystym tłem (RGBA). Obecny tylko wtedy, gdy zadanie zostało utworzone z alpha_thumbnail: true, a przezroczysty podgląd został pomyślnie wyrenderowany; w przeciwnym razie to pole jest pomijane.

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, wartość ta zmieni się na 100.

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

Liczba zadań poprzedzających.

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 znajdziesz w sekcji Błędy.

Liczba kredytów zużytych przez to zadanie. Obecna, gdy status zadania to PENDING, IN_PROGRESS lub SUCCEEDED. Zwraca 0 dla zadań FAILED (kredyty są zwracane w przypadku niepowodzenia).