Wenn Sie 3D-Assets über die Meshy API generieren, wird jedes Aufgabenergebnis vorübergehend auf den Servern von Meshy gespeichert. Wenn Sie den Aufbewahrungszeitraum kennen, können Sie Ihre Integration besser planen und sicherstellen, dass Sie die Ergebnisse herunterladen, bevor sie ablaufen.
Aufbewahrung von Assets nach Aufgabentyp
Die Aufbewahrungsfristen variieren je nach Aufgabentyp:
Aufgabentyp | Aufbewahrungszeitraum |
Text zu 3D | 3 Tage nach Abschluss der Aufgabe |
Bild zu 3D | 3 Tage nach Abschluss der Aufgabe |
Rigging | 2 Monate nach Abschluss der Aufgabe |
Text zu 3D und Bild zu 3D
Aufgaben und ihre Ergebnisse — Modelldateien, Vorschaubilder und Texturen — werden 3 Tage ab dem Zeitpunkt aufbewahrt, zu dem die Aufgabe abgeschlossen ist. Nach diesem Zeitraum sind die Aufgabe und alle zugehörigen Download-URLs nicht mehr zugänglich.
Jede API-Aufgabenantwort enthält ein expires_at-Feld (Unix-Zeitstempel in Millisekunden), das genau angibt, wann die Aufgabe gelöscht wird:
{
"id": "01abc123-...",
"status": "SUCCEEDED",
"expires_at": 1777029052743,
"result": {
"model_urls": { ... }
}
}
Überwachen Sie diesen Wert in Ihrer Integration und lösen Sie die Downloads aus, bevor er abläuft.
Rigging-Aufgaben
Rigging-Aufgaben werden 2 Monate nach Abschluss aufbewahrt. Dieses erweiterte Zeitfenster ermöglicht es Ihnen, mit der ursprünglichen Rigging-Aufgaben-ID weiterhin neue Animationen zu demselben geriggten Charakter hinzuzufügen — ohne das Mesh neu riggen zu müssen.
Um ein bestehendes Rig zu animieren, verweisen Sie in Ihrer Animationsanforderung jederzeit innerhalb des 2-monatigen Aufbewahrungszeitraums auf die Rigging-Aufgaben-ID.
Abrufen Ihrer Assets
So greifen Sie auf API-generierte Assets zu, bevor sie ablaufen:
Sofort herunterladen. Sobald eine Aufgabe den Status
SUCCEEDEDerreicht, laden Sie die Ausgabedateien (GLB, FBX, OBJ usw.) in Ihren eigenen Speicher herunter.Verwenden Sie den List-Tasks-Endpunkt. Rufen Sie aktuelle Aufgaben-IDs und Ausgabe-URLs über die List-API-Endpunkte für Text zu 3D oder Bild zu 3D ab.
FAQ
1. Warum erscheint mein API-generiertes Modell nicht in meinem Workspace?
Dies ist ein erwartetes Verhalten. API-generierte Assets erscheinen nicht in der Meshy-Workspace-Benutzeroberfläche. Dies ist beabsichtigt — die API und der Workspace haben separate Asset-Lebenszyklen mit unterschiedlichen Ablaufregeln.
2. Warum gibt meine Aufgaben-URL einen 404-Fehler zurück?
Wenn der expires_at-Zeitstempel der Aufgabe überschritten wurde, wurde das Asset von den Meshy-Servern gelöscht. Sie müssen die Generierungsaufgabe erneut einreichen. Um dies künftig zu vermeiden, richten Sie automatische Downloads in Ihren eigenen Speicher ein, sobald Aufgaben erfolgreich abgeschlossen sind.
3. Kann ich einem Charakter neue Animationen hinzufügen, nachdem die Rigging-Aufgabe abgelaufen ist?
Rigging-Aufgaben sind 2 Monate lang verfügbar, sodass Sie ample Zeit haben, weitere Animationen hinzuzufügen. Wenn die Rigging-Aufgabe abgelaufen ist (älter als 2 Monate), müssen Sie das ursprüngliche Mesh neu riggen.
Hinweis: Meshy garantiert keine Skelettkompatibilität zwischen separaten Rigging-Durchläufen.