Když generujete 3D assety prostřednictvím Meshy API, výsledek každého úkolu se dočasně ukládá na servery Meshy. Pochopení doby uchovávání vám pomůže naplánovat integraci a zajistit, že si výstupy stáhnete dříve, než vyprší.
Doba uchovávání podle typu úkolu
Doba uchovávání se liší podle typu úkolu:
Typ úkolu | Doba uchovávání |
Text to 3D | 3 dny po dokončení úkolu |
Image to 3D | 3 dny po dokončení úkolu |
Rigging | 2 měsíce po dokončení úkolu |
Text to 3D a Image to 3D
Úkoly a jejich výstupy — soubory modelů, náhledové obrázky a textury — jsou uchovávány po dobu 3 dnů od dokončení úkolu. Po uplynutí této doby již úkol a všechny související adresy URL ke stažení nebudou dostupné.
Odpověď na každý úkol API obsahuje pole expires_at (Unixový časový údaj v milisekundách), které přesně určuje, kdy bude úkol smazán:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Tuto hodnotu ve své integraci sledujte a spusťte stahování dříve, než vyprší.
Úkoly riggingu
Úkoly riggingu jsou uchovávány po dobu 2 měsíců po dokončení. Toto prodloužené okno vám umožňuje pokračovat v přidávání nových animací ke stejnému rigovanému znakovi pomocí původního ID rigovacího úkolu — aniž byste museli mesh rigovat znovu.
Chcete-li animovat existující rig, odkazujte na ID rigovacího úkolu v žádosti o animaci kdykoli v rámci dvouměsíční doby uchovávání.
Získávání vašich assetů
Chcete-li získat přístup k assetům vytvořeným přes API dříve, než vyprší:
Stahujte ihned. Jakmile úkol dosáhne stavu
SUCCEEDED, stáhněte si výstupní soubory (GLB, FBX, OBJ apod.) do vlastního úložiště.Použijte endpoint pro výpis úkolů. Získejte nedávná ID úkolů a adresy URL výstupů prostřednictvím endpointů API pro výpis Text to 3D nebo Image to 3D.
Časté dotazy
1. Proč se model vytvořený přes API nezobrazuje v mé pracovní ploše?
Jedná se o očekávané chování. Assety vytvořené přes API se v uživatelském rozhraní pracovní plochy Meshy nezobrazují. Je to záměr — API a pracovní plocha mají oddělené životní cykly assetů s odlišnými pravidly vypršení platnosti.
2. Proč moje adresy URL úkolů vracejí 404?
Pokud časový údaj expires_at úkolu již vypršel, asset byl ze serverů Meshy smazán. Budete muset odeslat generovací úkol znovu. Abyste tomu v budoucnu předešli, nastavte automatické stahování do vlastního úložiště hned po úspěšném dokončení úkolů.
3. Mohu po vypršení rigovacího úkolu přidat znakovi nové animace?
Úkoly riggingu jsou dostupné po dobu 2 měsíců, což vám poskytuje dostatečný čas na další přidávání animací. Pokud rigovací úkol vypršel (starší než 2 měsíce), budete muset původní mesh rigovat znovu.
Poznámka: Meshy negarantuje kompatibilitu kostry mezi jednotlivými rigovacími běhy.