Zum Hauptinhalt springen
Die Venice API existiert, um Entwicklern unbeschränkten privaten Zugang zu produktionstauglichen Modellen ohne versteckte Filter oder Blackbox-Entscheidungen zu bieten. Wenn Modelle besser werden, ziehen wir gelegentlich ältere zugunsten intelligenterer, schnellerer oder leistungsfähigerer Alternativen zurück. Wir gestalten diese Übergänge planbar und reibungsarm.

​
Modell-Deprecations

Wir wissen, dass Deprecations störend sein können. Deshalb deprecaten wir nur, wenn es notwendig ist, und entwerfen Funktionen wie Traits und Venice-gebrandete Modelle so, dass Unterbrechungen minimiert werden. Wir können ein Modell deprecaten, wenn:
  • Ein neueres Modell für denselben Use Case eine klare Verbesserung bietet
  • Das Modell unsere Standards für Performance oder Zuverlässigkeit nicht mehr erfüllt
  • Es durchgängig eine geringe Nutzung aufweist und seine weitere Unterstützung das Erlebnis für alle anderen fragmentieren würde

​
Deprecation-Prozess

Wenn ein Modell die Deprecation-Kriterien erfüllt, geben wir vor der Entfernung eine Vorlaufzeit von 7 bis 15 Tagen. Sie können bevorstehende Deprecations verfolgen über:
  • Den Model Deprecation Tracker weiter unten
  • Den API-Endpoint List Models (Modelle mit geplanter Außerbetriebnahme enthalten ein deprecation-Objekt)
  • Unser Changelog
  • E-Mail-Benachrichtigungen, die automatisch versendet werden, wenn Sie das Modell in den letzten 15 Tagen aufgerufen haben
Während des Ankündigungszeitraums enthalten Aufrufe an ein deprecated Modell eine Deprecation-Warnung in der API-Antwort. Während des Ankündigungszeitraums bleibt das Modell verfügbar, allerdings können wir in einigen Fällen die Infrastruktur-Kapazität reduzieren. Wir geben immer einen empfohlenen Ersatz an und bieten bei Bedarf Migrationsleitfäden an, um den Übergang zu erleichtern. Nach dem Sunset-Datum werden Anfragen an das Modell automatisch an ein Modell mit ähnlicher Rechenleistung zum gleichen oder niedrigeren Preis weitergeleitet. Wenn das Routing aus technischen oder Sicherheitsgründen nicht möglich ist, gibt die API eine 410-Gone-Antwort zurück. Wenn ein deprecated Modell über einen Trait (z. B. default_code, default_vision oder fastest) ausgewählt wurde, wird dieser Trait einem kompatiblen Ersatz zugewiesen. Wir entfernen niemals Modelle stillschweigend oder ändern Verhalten ohne Versionierung. Sie wissen immer, was läuft und wie Sie sich auf das Nächste vorbereiten können.
Reine Performance-Upgrades: Wir können Verbesserungen ausrollen, die das Modellverhalten beibehalten und gleichzeitig Performance, Latenz oder Kosteneffizienz verbessern. Diese Updates sind abwärtskompatibel und erfordern keine Kundenaktion.
Siehe den Model Deprecation Tracker unten. Für frühere Ankündigungen konsultieren Sie das Changelog.

​
Wie Modelle für die Venice API ausgewählt werden

Wir wählen sorgfältig aus, welche Modelle wir basierend auf Performance, Zuverlässigkeit und realen Entwicklerbedürfnissen verfügbar machen. Um aufgenommen zu werden, muss ein Modell starke Performance zeigen, sich unter OpenAI-kompatiblen Endpoints konsistent verhalten und gegenüber mindestens einem der bereits unterstützten Modelle eine klare Verbesserung bieten. Modelle, die wir evaluieren, können zunächst als Beta veröffentlicht werden, um Feedback zu sammeln und die Performance im großen Maßstab zu validieren. Wir stellen keine Modelle zur Verfügung, die redundant, unbewährt oder nicht bereit für den konsistenten Produktivbetrieb sind. Unser Ziel ist es, die Venice API sauber, leistungsfähig und auf das optimiert zu halten, was Entwickler tatsächlich bauen. Mehr erfahren Sie in Model Deprecations und der aktuellen Modellliste.

​
Versionierung und Aliase

Alle Venice-Modelle werden durch eine eindeutige, permanente ID identifiziert. Zum Beispiel: venice-uncensored zai-org-glm-4.7 zai-org-glm-5 qwen3-vl-235b-a22b Modell-IDs sind stabil. Bei einem Breaking Change veröffentlichen wir eine neue Modell-ID (zum Beispiel mit einer Versionsbezeichnung wie v2). Gibt es keine Breaking Changes, können wir das bestehende Modell aktualisieren und kommunizieren signifikante Änderungen. Um Flexibilität zu bieten, pflegt Venice außerdem symbolische Aliase, die über Traits implementiert sind und auf das empfohlene Standardmodell für eine bestimmte Aufgabe verweisen:
Traits bieten eine stabile Abstraktion zur Modellauswahl und geben Venice gleichzeitig die Flexibilität, die zugrunde liegende Implementierung zu verbessern. Entwickler, die einen automatischen Zugriff auf die jeweils neuesten empfohlenen Modelle bevorzugen, können sich auf trait-basierte Aliase verlassen. Für Anwendungen, die strikte Konsistenz und vorhersehbares Verhalten erfordern, empfehlen wir die Referenzierung fester Modell-IDs.

​
Feedback

Sie können Ihr Feedback oder Ihre Anfrage über unser Featurebase-Portal einreichen. Wir pflegen ein öffentliches Changelog, einen Roadmap-Tracker und eine transparente Begründung für das Hinzufügen, Aktualisieren oder Entfernen von Modellen und ermutigen zu kontinuierlicher Community-Beteiligung.

​
Model Deprecation Tracker

Die folgenden Modelle sind für die Deprecation vorgesehen oder wurden kürzlich deprecated. Wir empfehlen, vor dem Entfernungsdatum auf die vorgeschlagenen Ersatzmodelle zu migrieren. Modelle bleiben für 30 Tage nach ihrem Entfernungsdatum aufgelistet.

​
Deprecation-Status über die API prüfen

Sie können prüfen, ob ein Modell für die Außerbetriebnahme vorgesehen ist, indem Sie den List-Models-Endpoint aufrufen. Modelle mit einem Außerbetriebnahmedatum enthalten ein deprecation-Objekt in ihrer model_spec: 
{
  "id": "some-model-id",
  "model_spec": {
    "name": "Some Model",
    "privacy": "private",
    "deprecation": {
      "date": "2025-03-01T00:00:00.000Z"
    }
  },
  "type": "text",
  "object": "model",
  "owned_by": "venice.ai"
}
Das deprecation-Objekt erscheint nur, wenn ein Modell für die Außerbetriebnahme vorgesehen ist. Sie können if (model.model_spec.deprecation) prüfen, um zu erkennen, ob ein Modell außer Betrieb genommen wird, und das ISO-8601-Datum verwenden, um Benutzer zu warnen oder Migrationen zu planen.