Remesh API

ID ukończonego zadania Obraz na 3D lub Tekst na 3D, które chcesz poddać remeshowi. Zadanie to musi być jednym z następujących: Text to 3D Preview, Text to 3D Refine, Image to 3D lub Retexture. Dodatkowo musi mieć status SUCCEEDED.

Podaj model 3D, który Meshy ma poddać remeshowi, 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.

Lista docelowych formatów dla przetworzonego modelu. Jeśli parametr zostanie pominięty, generowany jest tylko format GLB.

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

Określa topology generowanego 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 generowanym 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 wartości zależy od poziomu użytkownika:

• od 100 do 300 000 (włącznie)

Włącza adaptacyjną decymację poprzez ustawienie poziomu liczby wielokątów. Gdy ten parametr jest ustawiony, target_polycount jest ignorowany.

Dostępne wartości:

• 1: Adaptacyjnie — bardzo wysoka liczba wielokątów.
• 2: Adaptacyjnie — wysoka liczba wielokątów.
• 3: Adaptacyjnie — średnia liczba wielokątów.
• 4: Adaptacyjnie — niska 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 bounding-boxa 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 odpowiedniej zmiany rozmiaru modelu. Zalecamy korzystanie z dedykowanego Resize API.

Jeśli true, usługa zmieni tylko format pliku wejściowego modelu, 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ć albo model_url, albo 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 na plik o nieobsługiwanym rozszerzeniu.
• Niedostępny URL: Nie udało się pobrać pliku spod model_url.
• Nieprawidłowy topology: Parametr topology jest nieprawidłowy.
• Wzajemnie wykluczające się parametry: Nie można jednocześnie ustawić 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 do usunięcia.

Numer strony do stronicowania.

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

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

Dostępne wartości:

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

Unikalny identyfikator zadania Remesh do strumieniowania.

Unikalny identyfikator zadania. Chociaż jako szczegół implementacyjny używamy dla identyfikatorów zadań k-sortowalnego UUID, nie powinieneś zakładać żadnego konkretnego formatu identyfikatora.

Typ zadania Remesh. Wartość to remesh.

Adres URL do pobrania pliku modelu 3D z teksturą 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 wygenerowanego z modelu po remeshu.

Adres URL do pobrania wersji thumbnail_url z przezroczystym tłem (RGBA). Obecne 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, przyjmie wartość 100.

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

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ń. Zobacz Błędy, aby poznać pełny opis obiektu task_error.

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