Gdy generujesz zasoby 3D za pomocą API Meshy, wynik każdego zadania jest tymczasowo przechowywany na serwerach Meshy. Znajomość okresu retencji pomaga zaplanować integrację i pobranie wyników, zanim wygasną.
Okres przechowywania zasobów według typu zadania
Okresy retencji różnią się w zależności od typu zadania:
Typ zadania | Okres przechowywania |
Text to 3D | 3 dni od zakończenia zadania |
Image to 3D | 3 dni od zakończenia zadania |
Rigging | 2 miesiące od zakończenia zadania |
Text to 3D i Image to 3D
Zadania i ich wyniki — pliki modeli, obrazy podglądowe i tekstury — są przechowywane przez 3 dni od momentu zakończenia zadania. Po tym okresie zadanie i wszystkie powiązane adresy URL do pobierania przestaną być dostępne.
Każda odpowiedź zadania API zawiera pole expires_at (znacznik czasu Unix w milisekundach) wskazujące dokładnie, kiedy zadanie zostanie usunięte:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Monitoruj tę wartość w swojej integracji i uruchamiaj pobieranie przed jej upływem.
Zadania Rigging
Zadania Rigging są przechowywane przez 2 miesiące od zakończenia. Ten wydłużony okres pozwala nadal dodawać nowe animacje do tego samego postaci z gotowym riggerem, używając oryginalnego ID zadania riggingu — bez konieczności ponownego rigowania siatki.
Aby animować istniejący rig, podaj ID zadania riggingu w żądaniu animacji w dowolnym momencie w okresie 2 miesięcy retencji.
Pobieranie swoich zasobów
Aby uzyskać dostęp do zasobów wygenerowanych przez API, zanim wygasną:
Pobierz natychmiast. Gdy tylko zadanie osiągnie status
SUCCEEDED, pobierz pliki wynikowe (GLB, FBX, OBJ itd.) do własnego magazynu.Użyj endpointu listy zadań. Pobierz ostatnie ID zadań i adresy URL wyników za pomocą endpointów API listy Text to 3D lub Image to 3D.
FAQ
1. Dlaczego mój model wygenerowany przez API nie pojawia się w moim workspace?
To oczekiwane zachowanie. Zasoby wygenerowane przez API nie pojawiają się w interfejsie Workspace Meshy. Celowo zaprojektowano je tak — API i Workspace mają oddzielne cykle życia zasobów z różnymi regułami wygasania.
2. Dlaczego adresy URL mojego zadania zwracają 404?
Jeśli znacznik czasu expires_at zadania już minął, zasób został usunięty z serwerów Meshy. Musisz ponownie przesłać zadanie generowania. Aby uniknąć tej sytuacji w przyszłości, skonfiguruj automatyczne pobieranie do własnego magazynu, gdy tylko zadania się zakończą pomyślnie.
3. Czy mogę dodać nowe animacje do postaci po wygaśnięciu zadania riggingu?
Zadania riggingu są dostępne przez 2 miesiące, co daje Ci wystarczająco dużo czasu na dodawanie animacji. Jeśli zadanie riggingu wygasło (starsze niż 2 miesiące), konieczne będzie ponowne rigowanie oryginalnej siatki.
Uwaga: Meshy nie gwarantuje kompatybilności szkieletu między osobnymi uruchomieniami riggingu.