API Remesh

ID ukończonego zadania Obraz na 3D lub Tekst na 3D, które chcesz poddać Remesh. To zadanie musi być jednym z następujących zadań: Podgląd Tekst na 3D, Udoskonalenie Tekst na 3D, Obraz na 3D lub Reteksturowanie. Ponadto musi mieć status SUCCEEDED.

Podaj model 3D dla Meshy do wykonania Remesh za pośrednictwem publicznie dostępnego adresu URL lub Data URI. Obsługiwane formaty: .glb, .gltf, .obj, .fbx, .stl.

Dla Data URI użyj MIME type: application/octet-stream.

Lista formatów docelowych dla modelu po Remesh. Jeśli zostanie pominięta, generowany jest tylko GLB.

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

Określ topology wygenerowanego modelu.

Dostępne wartości:

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

Określ 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 wartości różni się w zależności od poziomu użytkownika:

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

Włącz adaptacyjną decymację, ustawiając poziom liczby wielokątów. Po ustawieniu target_polycount jest ignorowane.

Dostępne wartości:

• 1: Adaptacyjna — ultra liczba wielokątów.
• 2: Adaptacyjna — wysoka liczba wielokątów.
• 3: Adaptacyjna — średnia liczba wielokątów.
• 4: Adaptacyjna — niska liczba wielokątów.

Zmień rozmiar modelu do określonej wysokości mierzonej w metrach. Zamiast tego zalecamy użycie dedykowanego API Zmień rozmiar.

Zmień rozmiar modelu tak, aby najdłuższy wymiar ramki ograniczającej był równy określonej wartości w metrach. Zamiast tego zalecamy użycie dedykowanego API Zmień rozmiar.

Po ustawieniu na true usługa używa wizji AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniej zmiany rozmiaru modelu. Zamiast tego zalecamy użycie dedykowanego API Zmień rozmiar.

Jeśli true, usługa zmieni tylko format wejściowego pliku modelu, ignorując inne dane wejściowe, takie jak topology, resize_height i target_polycount. Zamiast tego zalecamy użycie dedykowanego API Konwertuj.

Po ustawieniu 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 niedopuszczalne. Typowe przyczyny:

• Brakujący parametr: Należy podać 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 plik z nieobsługiwanym rozszerzeniem.
• Nieosiągalny URL: Nie można było pobrać model_url.
• Nieprawidłowa topology: Parametr topology jest nieprawidłowy.
• Parametry wzajemnie się wykluczające: auto_size i resize_height nie mogą być ustawione jednocześnie.

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 liczba to 50 elementów.

Pole, według którego należy sortować.

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ż używamy sortowalnego typu k UUID dla identyfikatorów zadań jako szczegółu implementacyjnego, nie należy przyjmować żadnych założeń dotyczących formatu identyfikatora.

Typ zadania Remesh. Wartość to remesh.

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

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

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

Progress zadania. Jeśli zadanie nie zostało jeszcze rozpoczęte, ta właściwość będzie miała wartość 0. Po pomyślnym zakończeniu zadania zmieni się na 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 nie zostało jeszcze rozpoczęte, ta właściwość będzie miała wartość 0.

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

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

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).