Cykl życia zadania
Dowiedz się, jak zadanie przechodzi od żądania do wyniku, ile zwykle to trwa i jak długo Twój kod powinien na nie czekać.
Jak przebiega zadanie
Żądanie utworzenia zwraca identyfikator zadania bez oczekiwania na jego wykonanie. Zadanie działa następnie w tle, a Ty możesz śledzić je na jeden z trzech sposobów: odpytując jego punkt końcowy GET, otwierając jego punkt końcowy strumieniowy lub odbierając webhook.
PENDING. Worker podejmuje je i przechodzi ono do stanu IN_PROGRESS, w którym spędza większość czasu. Kończy się ono w stanie SUCCEEDED lub FAILED, a status końcowy nigdy się nie zmienia.PENDINGIN_PROGRESSSUCCEEDEDFAILEDZadanie zapisuje każdy etap w swoich polach created_at, started_at i finished_at.
Poniższa tabela pokazuje, co Twój kod powinien zrobić przy każdym statusie.
| Status | Co powinien zrobić Twój kod |
|---|---|
PENDING | Kontynuuj oczekiwanie. |
IN_PROGRESS | Śledź progress: procent ukończonej pracy, od 0 do 100. |
SUCCEEDED | Pobierz wynik. Meshy przechowuje pliki przez ograniczony czas. Zobacz Przechowywanie zasobów. |
FAILED | Odczytaj task_error, a następnie popraw dane wejściowe lub utwórz nowe zadanie. Zobacz Błędy. |
CANCELED | Przestań czekać. Zadanie nie wygeneruje wyniku. Tylko zadania Creative Lab używają tego statusu. |
SUCCEEDED, FAILED i CANCELED są statusami końcowymi. Gdy zadanie osiągnie jeden z nich, jego status nigdy więcej się nie zmienia.
Z poziomu Twojego kodu wygląda to tak:
Żądanie: POST/image-to-3d
Odpowiedź: 202{ "result": "<task_id>" }zadanie utworzone
- Powtarzaj co kilka sekund
Żądanie: GET/image-to-3d/<task_id>
Odpowiedź: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5
Żądanie: GET/image-to-3d/<task_id>
Odpowiedź: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }
GET) z użyciem tego samego identyfikatora zadania.Czasy przetwarzania
Poniższe tabele pokazują mediany czasów dla ruchu produkcyjnego API we wrześniu 2026 roku.
Czas liczony jest od utworzenia zadania do osiągnięcia statusu końcowego. Niemal cały ten czas to przetwarzanie, ponieważ zadanie zwykle pozostaje w stanie PENDING jedynie przez kilka sekund. Gdy kolejka jest obciążona, zadania mogą czekać dłużej, zanim się rozpoczną, a zadania w planach o wyższym priorytecie zwykle rozpoczynają się szybciej.
Czasy poniżej 2 minut podane są w sekundach (s), a dłuższe czasy w minutach (min). „Niewspierane” oznacza, że API nie oferuje tej opcji dla danego modelu.
Są to typowe czasy, a nie gwarantowane czasy ukończenia. W okresach dużego obciążenia niektóre zadania trwają dłużej, ale nadal kończą się powodzeniem. Aby sprawdzić status Meshy, zobacz stronę statusu. Nie używaj tych czasów jako wartości timeout w swoim kodzie. Wartości timeout znajdziesz w sekcji Jak długo czekać.
Generowanie 3D
| API | Konfiguracja | meshy-7.1 (latest) | meshy-6 | meshy-6-lite | meshy-t2 |
|---|---|---|---|---|---|
| Tekst na 3D (Preview) | Tylko siatka | 75 s | 90 s | 45 s | 10 s |
| Obraz na 3D | Tylko siatka | 75 s | 90 s | 40 s | 4 s |
| Siatka z teksturami 2K | 2 min | 3 min | 75 s | 60 s | |
| Siatka z teksturami 4K | 2,5 min | 3,5 min | Niewspierane | 80 s | |
| Siatka z teksturami 8K | 3,5 min | 4 min | Niewspierane | 2,5 min | |
| Wiele obrazów na 3D | Tylko siatka | 65 s | 2 min | 30 s | Niewspierane |
| Siatka z teksturami 2K | 2,5 min | 3,5 min | 85 s | Niewspierane | |
| Siatka z teksturami 4K | 3 min | 4 min | Niewspierane | Niewspierane | |
| Siatka z teksturami 8K | 3,5 min | 4,5 min | Niewspierane | Niewspierane |
Dla Obraz na 3D i Wiele obrazów na 3D „Tylko siatka” oznacza should_texture: false. Następujące opcje i dane wejściowe zmieniają czas:
- Mapy PBR (
enable_pbr) dodają od 30 do 60 sekund. - Geometria Ultra (
geometry_resolution: "2k"lub"4k") dodaje do 1 minuty. - Przy tych samych ustawieniach bardziej złożone obrazy wejściowe wymagają więcej czasu.
Teksturowanie
| API | Rozdzielczość tekstury | Typowy czas |
|---|---|---|
| Tekst na 3D (Refine) | 2K lub 4K | 80 s |
| 8K | 3,5 min | |
| Reteksturowanie | 2K | 55 s |
| 4K | 90 s | |
| 8K | 2,5 min |
Generowanie obrazów
| API | nano-banana | nano-banana-2 | nano-banana-pro | Modele GPT Image |
|---|---|---|---|---|
| Tekst na obraz | 20 s | 15 s | 25 s | od 20 do 35 s |
| Obraz na obraz | 40 s | 20 s | 30 s | od 20 do 40 s |
Rigging i Animacja
| API | Konfiguracja | Typowy czas |
|---|---|---|
| Auto-Rigging | Automatyczny rigging | 40 s |
| Animacja | Na żądanie | 15 s |
| Tekst na ruch | mode prime | 15 s |
mode swift | 10 s |
Przetwarzanie końcowe
| API | Typowy czas |
|---|---|
| Remesh | 2 min |
| Rozwinięcie UV | 35 s |
| Konwertuj | 7 s |
| Zmień rozmiar | 15 s |
Druk 3D
| API | Konfiguracja | Typowy czas |
|---|---|---|
| Analizuj drukowalność | Tylko kontrole siatki | 1 s |
| Kontrole siatki i cienkich ścianek | 10 s | |
| Multi-Color | Na żądanie | 30 s |
| Napraw drukowalność | Tylko naprawa siatki | 10 s |
| Kontrola cienkich ścianek, ścianki zachowane | 20 s | |
| Kontrola cienkich ścianek, ścianki pogrubione | 100 s | |
| Auto Split | Części w jednolitym kolorze | 70 s |
Części teksturowane (keep_texture: true) | 170 s |
W v2 Napraw drukowalność oraz Analizuj drukowalność zawsze przeprowadzają kontrolę cienkich ścianek. W v1 wykonują ją, gdy podasz typ drukarki lub rozmiar wydruku.
Jak długo czekać
Zadanie działa nadal, nawet jeśli Twój kod przestanie czekać. Jeśli Twoje żądanie przekroczy timeout, połączenie zostanie przerwane lub strumień się zamknie, zadanie nie kończy się niepowodzeniem ani nie jest anulowane.
- Poczekaj co najmniej 60 minut, licząc od
created_atzadania, zanim przestaniesz czekać. Jeśli przestaniesz wcześniej, możesz przegapić zadanie, które zakończy się powodzeniem później. Zdarza się to głównie w okresach dużego obciążenia. - Zachowaj identyfikator zadania. Możesz pobrać zadanie ponownie w dowolnym momencie. Jeśli po 60 minutach nadal nie ma statusu końcowego, sprawdź je ponownie później. Jeśli stan się nie zmienia, skontaktuj się z pomocą techniczną.
- Tylko
FAILEDoznacza, że zadanie zakończyło się niepowodzeniem. Meshy automatycznie zwraca kredyty za nieudane zadania.
Użyj tych wartości w swoim kodzie:
| Ustawienie | Zalecana wartość |
|---|---|
Timeout żądania utworzenia (POST) | 60 sekund |
Timeout żądania utworzenia (POST) z plikiem model_url powyżej 100 MB | 120 sekund. Meshy pobiera plik, zanim odpowie. |
Timeout żądania statusu (GET) | 30 sekund |
| Interwał odpytywania | Nagłówek Retry-After, lub 5 sekund, jeśli go brakuje. Odpytywania liczą się do Twojego limitu szybkości. |
Nieudane żądanie statusu (timeout, 429 lub 5xx) | Spróbuj ponownie przy następnym odpytaniu. Nie oznacza to, że zadanie zakończyło się niepowodzeniem. |
| Łączny czas oczekiwania na zadanie | Co najmniej 60 minut od created_at. Nie resetuj tego licznika przy ponownym połączeniu strumienia. |
| Strumień | Strumień może zamknąć się przed zakończeniem zadania. Jeśli zamknie się bez statusu końcowego, połącz się ponownie lub przełącz się na odpytywanie. |
W przypadku wielu zadań jednocześnie użyj webhooków zamiast odpytywania każdego z nich. Jeśli zdarzenie końcowe zadania nie nadeszło po około dwukrotności jego typowego czasu, pobierz zadanie z jego punktu końcowego GET.