Passer au contenu principal
L’API Venice existe pour donner aux développeurs un accès privé et sans restriction à des modèles de qualité production, sans filtres cachés ni décisions opaques. À mesure que les modèles s’améliorent, nous retirons occasionnellement les plus anciens au profit d’alternatives plus intelligentes, plus rapides ou plus performantes. Nous concevons ces transitions pour qu’elles soient prévisibles et sans friction.

​
Dépréciations de modèles

Nous savons que les dépréciations peuvent être perturbantes. C’est pourquoi nous visons à ne déprécier que lorsque c’est nécessaire, et nous concevons des fonctionnalités comme les caractéristiques (traits) et les modèles de la marque Venice pour minimiser les perturbations. Nous pouvons déprécier un modèle lorsque :
  • Un modèle plus récent offre une amélioration claire pour le même cas d’usage
  • Le modèle ne répond plus à nos standards de performance ou de fiabilité
  • Il enregistre une utilisation systématiquement faible, et continuer à le prendre en charge fragmenterait l’expérience pour tous les autres

​
Processus de dépréciation

Lorsqu’un modèle répond aux critères de dépréciation, nous annonçons le changement avec un préavis de 30 à 60 jours. Les avis de dépréciation sont publiés via le changelog et notre serveur Discord. Lorsque vous appelez un modèle déprécié pendant la période de préavis, la réponse de l’API inclura un avertissement de dépréciation. Pendant la période de préavis, le modèle reste disponible, bien que dans certains cas nous puissions réduire la capacité d’infrastructure. Nous fournissons toujours un remplacement recommandé et, si nécessaire, des conseils de migration pour aider la transition. Après la date de retrait, les requêtes vers le modèle seront automatiquement routées vers un modèle de puissance de traitement similaire au même prix ou à un prix inférieur. Si le routage n’est pas possible pour des raisons techniques ou de sécurité, l’API renverra une réponse 410 Gone. Si un modèle déprécié a été sélectionné via une caractéristique (telle que default_code, default_vision ou fastest), cette caractéristique sera réaffectée à un remplacement compatible. Nous ne retirons jamais de modèles silencieusement ni n’altérons le comportement sans versioning. Vous saurez toujours ce qui s’exécute et comment vous préparer à la suite.
Mises à niveau de performance uniquement : Nous pouvons déployer des améliorations qui préservent le comportement du modèle tout en améliorant les performances, la latence ou l’efficacité des coûts. Ces mises à jour sont rétrocompatibles et ne nécessitent aucune action client.
Voir le Suivi de dépréciation des modèles ci-dessous. Pour les annonces antérieures, consultez le changelog et notre serveur Discord.

​
Comment les modèles sont sélectionnés pour l’API Venice

Nous sélectionnons soigneusement les modèles à rendre disponibles en fonction des performances, de la fiabilité et des besoins réels des développeurs. Pour être inclus, un modèle doit démontrer de solides performances, se comporter de manière cohérente sous des endpoints compatibles OpenAI et offrir une amélioration claire par rapport à au moins un des modèles que nous prenons déjà en charge. Les modèles que nous évaluons peuvent d’abord être publiés en beta pour recueillir des retours et valider les performances à grande échelle. Nous n’exposons pas les modèles qui sont redondants, non éprouvés ou non prêts pour une utilisation cohérente en production. Notre objectif est de garder l’API Venice propre, performante et optimisée pour ce que les développeurs construisent réellement. En savoir plus dans Dépréciations de modèles et Liste actuelle des modèles.

​
Versioning et alias

Tous les modèles Venice sont identifiés par un ID unique et permanent. Par exemple : venice-uncensored zai-org-glm-4.7 zai-org-glm-5 qwen3-vl-235b-a22b Les ID de modèles sont stables. En cas de changement non rétrocompatible, nous publierons un nouvel ID de modèle (par exemple, en ajoutant une version comme v2). En l’absence de changement non rétrocompatible, nous pouvons mettre à jour le modèle existant et nous communiquerons les changements significatifs. Pour offrir de la flexibilité, Venice maintient également des alias symboliques, implémentés via les caractéristiques, qui pointent vers le modèle par défaut recommandé pour une tâche donnée :
Les caractéristiques offrent une abstraction stable pour sélectionner des modèles tout en donnant à Venice la flexibilité d’améliorer l’implémentation sous-jacente. Les développeurs qui préfèrent un accès automatique aux derniers modèles recommandés peuvent s’appuyer sur des alias basés sur les caractéristiques. Pour les applications qui nécessitent une cohérence stricte et un comportement prévisible, nous recommandons de référencer des ID de modèles fixes.

​
Retours

Vous pouvez soumettre vos retours ou demandes via notre portail Featurebase. Nous maintenons un changelog public, un suivi de roadmap et une justification transparente pour l’ajout, la mise à niveau ou la suppression de modèles, et nous encourageons une participation continue de la communauté.

​
Suivi de dépréciation des modèles

Les modèles suivants sont programmés pour dépréciation ou ont été récemment dépréciés. Nous recommandons de migrer vers les remplacements suggérés avant la date de retrait. Les modèles restent listés pendant 30 jours après leur date de retrait.

​
Vérifier le statut de dépréciation via l’API

Vous pouvez vérifier si un modèle est programmé pour le retrait en appelant l’endpoint List Models. Les modèles avec une date de retrait incluent un objet deprecation dans leur 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"
}
L’objet deprecation n’apparaît que lorsqu’un modèle est programmé pour le retrait. Vous pouvez vérifier if (model.model_spec.deprecation) pour savoir si un modèle est en cours de retrait, et utiliser la date ISO 8601 pour avertir les utilisateurs ou planifier des migrations.