Deprecations
Erfahren Sie, welche Meshy-KI-Modelle und API-Funktionen aktiv, veraltet oder eingestellt sind, und finden Sie Einstellungstermine sowie empfohlene Ersatzlösungen.
Wenn Meshy neue Modelle veröffentlicht, werden ältere eingestellt. Integrationen, die auf einem älteren Modell oder einer älteren API-Funktion basieren, müssen gelegentlich aktualisiert werden, damit sie weiter funktionieren. Diese Seite listet jede API-Deprecation zusammen mit der empfohlenen Ersatzlösung auf.
Überblick
Meshy verwendet folgende Begriffe, um den Lebenszyklus eines Modells oder einer API-Funktion zu beschreiben:
- Aktiv: Vollständig unterstützt und zur Verwendung empfohlen.
- Legacy: Erhält keine Updates mehr und kann in Zukunft als veraltet markiert werden. Es funktioniert noch, und an Ihrer Anfrage oder Ihrer Rechnung ändert sich nichts.
- Veraltet: Funktioniert noch, wird aber nicht mehr empfohlen. Meshy nennt eine empfohlene Ersatzlösung und, sobald geplant, ein Einstellungsdatum.
- Eingestellt: Nicht mehr verfügbar. Anfragen, die ein eingestelltes Modell oder eine eingestellte Funktion verwenden, liefern einen Fehler zurück.
Das Einstellen eines Modells löscht nicht, was Sie bereits damit erstellt haben. Tasks, die Sie mit einem eingestellten Modell erstellt haben, bleiben für den üblichen Aufbewahrungszeitraum verfügbar.
Migration zu Ersatzmodellen
Sobald ein Modell als veraltet markiert ist, übertragen Sie alle Ihre Anfragen vor dem Einstellungsdatum auf dessen Ersatzlösung. Anfragen, die das Modell nach diesem Datum verwenden, schlagen fehl.
Eine Ersatzlösung kann andere Ergebnisse liefern als das Modell, das sie ersetzt. Testen Sie Ihre Integration mit der Ersatzlösung rechtzeitig vor dem Einstellungsdatum, zum Beispiel im Playground.
Benachrichtigungen
Meshy kündigt jede Deprecation und Einstellung im Changelog und auf dieser Seite an. Solange eine Einstellung bevorsteht, zeigt ein Banner am oberen Rand jeder API-Seite dies an, und die Endpunkt-Seiten markieren das Modell oder den Parameter als veraltet.
Meshy kündigt ein Einstellungsdatum mindestens einen Monat vor der Einstellung an.
Best Practices
- Prüfen Sie regelmäßig den Changelog und diese Seite auf Deprecation-Updates.
- Setzen Sie
ai_modelauf ein bestimmtes Modell, zum Beispielmeshy-7.1, wenn Ihre Integration konsistente Ausgaben benötigt.latestverweist immer auf das neueste Standardmodell, sodass sich dessen Ausgabe ändert, wenn ein neues Modell veröffentlicht wird. - Testen Sie Ihre Integration mit der Ersatzlösung rechtzeitig vor dem Einstellungsdatum Ihres aktuellen Modells.
- Aktualisieren Sie Ihren Code so bald wie möglich, um die empfohlene Ersatzlösung zu verwenden.
- Kontaktieren Sie support@meshy.ai, wenn Sie Hilfe bei einer Migration benötigen.
Modellstatus
Aktuelle und eingestellte 3D-Generierungsmodelle von Text zu 3D, Bild zu 3D, Multi-Bild zu 3D und Neutexturierung. Nicht jeder Endpunkt bietet jedes Modell an; jede Endpunkt-Seite listet die Modelle auf, die sie akzeptiert.
| API-Modellname | Aktueller Status | Veraltet seit | Einstellungsdatum |
|---|---|---|---|
meshy-7.1 | Aktiv | Nicht zutreffend | Nicht zutreffend |
meshy-7 | Veraltet | 18. September 2026 | 31. Dezember 2026 (Geometrie); Nicht zutreffend (Textur) |
meshy-6 | Aktiv | Nicht zutreffend | Nicht zutreffend |
meshy-6-lite | Aktiv | Nicht zutreffend | Nicht zutreffend |
meshy-n1 | Aktiv | Nicht zutreffend | Nicht zutreffend |
meshy-5 | Eingestellt | 11. September 2026 | 10. Oktober 2026 |
meshy-4 | Eingestellt | Nicht zutreffend | 20. März 2026 |
meshy-3 | Eingestellt | 14. Januar 2025 | Juli 2025 |
meshy-t2.5 | Aktiv | Nicht zutreffend | Nicht zutreffend |
meshy-t2 | Aktiv | Nicht zutreffend | Nicht zutreffend |
meshy-t1 | Veraltet | 13. Juli 2026 | 30. November 2026 |
model_type: "lowpoly" | Veraltet | 13. Juli 2026 | 30. November 2026 |
latest löst sich zu meshy-7.1 auf.
Die Einstellung von meshy-7 betrifft es als ai_model von Text zu 3D-Preview-Tasks, Bild zu 3D und Multi-Bild zu 3D. meshy-7.1 verwendet dieselben Parameter und kostet gleich viel. Ab dem 31. Dezember 2026 geben diese Anfragen 400 zurück.
meshy-7 als Texturmodell ist davon nicht betroffen. Das betrifft Neutexturierung, texture_model und den ai_model-Parameter eines Text-zu-3D-Refine, der nur das Texturmodell auswählt.
Bis zum 30. November 2026 laufen diese Anfragen weiterhin auf einem Smart-Topology-Modell mit Dreiecks-topology und kosten den Smart-Topology-Preis:
- Bild zu 3D mit
model_type: "smart-topology"undai_model: "meshy-t1", oder mitmodel_type: "lowpoly"und weggelassenemai_model,latestodermeshy-6. Meshy ignoriert dabeitarget_polycount,topology,image_enhancement,remove_lightingundexperimental. - Ein Text zu 3D-Preview mit
model_type: "lowpoly"und weggelassenemai_model,latest,meshy-6odermeshy-4(ansonsten eingestellt;meshy-4wird hier nur für diesen Fallback akzeptiert). Meshy ignoriert dabeitarget_polycount,topologyundexperimental.
Jede andere Anfrage für meshy-t1 oder lowpoly liefert bereits 400 zurück. Ab dem 30. November 2026 liefern auch diese 400 zurück.
Verlauf der Deprecations
Alle Deprecations sind unten aufgelistet, mit den jüngsten Ankündigungen zuerst.
| Angekündigt | Veraltetes Modell oder veraltete Funktion | Einstellungsdatum | Empfohlene Ersatzlösung |
|---|---|---|---|
| 2026-10-02 | model_type: "lowpoly" und meshy-t1 bei Text zu 3D und Bild zu 3D | 30. November 2026 | model_type: "smart-topology" mit ai_model: "meshy-t2.5" |
| 2026-09-29 | /v2/text-to-3d ohne das /openapi-Präfix | Wird noch bekannt gegeben | /openapi/v2/text-to-3d |
| 2026-09-18 | meshy-7 als ai_model von Text zu 3D-Preview, Bild zu 3D und Multi-Bild zu 3D | 31. Dezember 2026 | meshy-7.1 |
| 2026-09-16 | Gemeinsam genutzter Test-Modus-API-Schlüssel | 16. September 2026 | Ihr eigener Schlüssel von der Seite „API-Schlüssel“ oder dem Playground |
| 2026-09-11 | meshy-5 | 10. Oktober 2026 | meshy-6-lite |
| 2026-03-20 | meshy-4 | 20. März 2026 | meshy-6 |
| 2025-10-01 | Text-zu-Voxel-API | 1. Oktober 2025 | Keine |
| 2025-07-01 | Text-zu-Textur-API | 1. Juli 2025 | Neutexturierung |
| 2025-01-14 | meshy-3 | Juli 2025 | meshy-6 |
API-Parameter-Deprecations
Meshy markiert gelegentlich Request-Parameter und Response-Felder als veraltet, die neuere Modelle ersetzen oder nicht mehr verwenden. Sie funktionieren weiterhin, sofern nicht anders angegeben, aber ein zukünftiges Release kann sie entfernen.
| Parameter | Status | Verhalten | Empfohlene Ersatzlösung |
|---|---|---|---|
texture_image_url bei Rigging | Veraltet seit 23. Oktober 2026 | Funktioniert weiterhin. Das Bild wird zur einzigen Textur des gerigten Modells, und das Modell verliert seine PBR-Texturen. | Weglassen. Meshy verwendet die Texturen von model_url oder des Eingabe-Tasks. |
ultra_mode | Veraltet seit 18. September 2026 | ultra_mode: true entspricht geometry_resolution: "2k". | geometry_resolution |
hd_texture | Veraltet seit 21. Juli 2026 | hd_texture: true entspricht texture_resolution: "4k". Wenn Sie beide senden, verwendet Meshy texture_resolution. | texture_resolution |
| Konvertierungs- und Größenänderungsparameter von Neuvernetzung | Veraltet seit 22. Mai 2026 | Funktionieren weiterhin. | Konvertieren und Größe ändern |
symmetry_mode | Veraltet seit 11. Mai 2026 | Wird akzeptiert und ignoriert. | Weglassen. |
art_style beim Text-zu-3D-Preview | Veraltet seit 22. Januar 2026 | Wird akzeptiert und ignoriert. Er galt nur für Meshy 4 und Meshy 5. | Weglassen. |
is_a_t_pose | Veraltet seit 4. Dezember 2025 | Funktioniert weiterhin. | pose_mode |