Remesh API

ID zakończonego zadania Obraz na 3D lub Tekst na 3D, które chcesz przetworzyć na 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. Dodatkowo, musi mieć status SUCCEEDED.

Proszę podać model 3D dla Meshy do przetworzenia na remesh za pośrednictwem publicznie dostępnego URL lub Data URI. Obsługiwane formaty: .glb, .gltf, .obj, .fbx, .stl.

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

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

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

Określ topology generowanego modelu.

Dostępne wartości:

• quad: Generuj siatkę z dominującymi czworokątami.
• triangle: Generuj zredukowaną siatkę trójkątów.

Określ docelową liczbę wielokątów w generowanym modelu. Rzeczywista liczba wielokątów może odbiegać od celu w zależności od złożoności geometria.

Prawidłowy zakres wartości zależy od poziomu użytkownika:

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

Włącz adaptacyjną redukcję przez ustawienie poziomu liczby wielokątów. Gdy ustawione, target_polycount jest ignorowane.

Dostępne wartości:

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

Zmień rozmiar modelu do określonej wysokości mierzonej w metrach. Zalecamy użycie dedykowanego API zmiany rozmiaru.

Zmień rozmiar modelu, aby najdłuższy wymiar obwiedni był równy określonej wartości w metrach. Zalecamy użycie dedykowanego API zmiany rozmiaru.

Gdy ustawione na true, usługa używa wizji AI do automatycznego oszacowania rzeczywistej wysokości obiektu i odpowiedniego zmiany rozmiaru modelu. Zalecamy użycie dedykowanego API zmiany rozmiaru.

Jeśli true, usługa zmieni tylko format pliku wejściowego modelu, ignorując inne wejścia jak topology, resize_height i target_polycount. Zalecamy użycie dedykowanego API konwersji.

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

Żądanie było nieakceptowalne. Typowe przyczyny:

• Brakujący parametr: Musi być podany model_url lub input_task_id.
• Nieprawidłowe zadanie wejściowe: input_task_id musi odnosić się do pomyślnego zadania z obsługiwanego modelu.
• Nieprawidłowy format modelu: model_url wskazuje na plik z nieobsługiwanym rozszerzeniem.
• Nieosiągalny URL: model_url nie mógł zostać pobrany.
• Nieprawidłowa topology: Parametr topology jest nieprawidłowy.
• Wzajemnie wykluczające się parametry: auto_size i resize_height nie mogą być ustawione jednocześnie.

Uwierzytelnianie nie powiodło się. Proszę sprawdzić swój klucz API.

Niewystarczające kredyty do wykonania tego zadania.

Przekroczyłeś swój limit szybkości.

ID zadania remesh do pobrania.

ID zadania remesh do usunięcia.

Numer strony dla stronicowania.

Limit rozmiaru strony. Maksymalnie dozwolone to 50 elementów.

Pole do sortowania.

Dostępne wartości:

• +created_at: Sortuj według czasu utworzenia w porządku rosnącym.
• -created_at: Sortuj według czasu utworzenia w porządku malejącym.

Unikalny identyfikator dla zadania Remesh do strumieniowania.

Unikalny identyfikator zadania. Chociaż używamy UUID sortowalnego k dla identyfikatorów zadań jako szczegółu implementacji, nie powinieneś zakładać żadnych założeń dotyczących formatu id.

Typ zadania Remesh. Wartość to remesh.

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

Pobieralny URL do obrazu podglądu renderowanego z modelu po remeshu.

Pobieralny URL do 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 jeszcze się nie rozpoczęło, ta właściwość będzie miała wartość 0. Gdy zadanie zakończy się sukcesem, stanie się 100.

Status zadania. Możliwe wartości to 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 dla pełnej referencji 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).