Saltar al contenido principal
La API de Venice existe para dar a los desarrolladores acceso privado y sin restricciones a modelos de calidad de producción, libres de filtros ocultos o decisiones opacas. A medida que los modelos mejoran, ocasionalmente retiramos los más antiguos en favor de alternativas más inteligentes, rápidas o capaces. Diseñamos estas transiciones para que sean predecibles y con poca fricción.

​
Deprecaciones de modelos

Sabemos que las deprecaciones pueden ser disruptivas. Por eso intentamos deprecar solo cuando es necesario y diseñamos funciones como las características y los modelos con marca Venice para minimizar la disrupción. Podemos deprecar un modelo cuando:
  • Un modelo más nuevo ofrece una mejora clara para el mismo caso de uso
  • El modelo ya no cumple nuestros estándares de rendimiento o fiabilidad
  • Tiene un uso consistentemente bajo, y seguir manteniéndolo fragmentaría la experiencia para los demás

​
Proceso de deprecación

Cuando un modelo cumple los criterios de deprecación, anunciamos el cambio con 30-60 días de antelación. Los avisos de deprecación se publican en el changelog y en nuestro servidor de Discord. Cuando llamas a un modelo deprecado durante el periodo de aviso, la respuesta de la API incluirá una advertencia de deprecación. Durante el periodo de aviso, el modelo sigue disponible, aunque en algunos casos podemos reducir la capacidad de infraestructura. Siempre proporcionamos un reemplazo recomendado y, cuando es necesario, ofrecemos orientación de migración para facilitar la transición. Después de la fecha de retirada, las solicitudes al modelo se enrutarán automáticamente a un modelo de potencia de procesamiento similar al mismo precio o inferior. Si el enrutamiento no es posible por razones técnicas o de seguridad, la API devolverá una respuesta 410 Gone. Si un modelo deprecado fue seleccionado mediante una característica (como default_code, default_vision o fastest), esa característica se reasignará a un reemplazo compatible. Nunca retiramos modelos en silencio ni alteramos su comportamiento sin versionado. Siempre sabrás qué se está ejecutando y cómo prepararte para lo que viene.
Mejoras solo de rendimiento: podemos lanzar mejoras que preservan el comportamiento del modelo mientras mejoran el rendimiento, la latencia o la eficiencia de coste. Estas actualizaciones son compatibles hacia atrás y no requieren acción del cliente.
Consulta el Tracker de deprecación de modelos más abajo. Para anuncios anteriores, consulta el changelog y nuestro servidor de Discord.

​
Cómo se seleccionan los modelos para la API de Venice

Seleccionamos cuidadosamente qué modelos hacer disponibles según rendimiento, fiabilidad y necesidades reales de los desarrolladores. Para ser incluido, un modelo debe demostrar un rendimiento sólido, comportarse de forma consistente con los endpoints compatibles con OpenAI y ofrecer una mejora clara sobre al menos uno de los modelos que ya admitimos. Los modelos que estamos evaluando pueden lanzarse primero en beta para recoger feedback y validar el rendimiento a gran escala. No exponemos modelos que sean redundantes, no probados o no estén listos para un uso consistente en producción. Nuestro objetivo es mantener la API de Venice limpia, capaz y optimizada para lo que los desarrolladores realmente construyen. Aprende más en Deprecaciones de modelos y Lista actual de modelos.

​
Versionado y aliases

Todos los modelos de Venice se identifican mediante un ID único y permanente. Por ejemplo: venice-uncensored zai-org-glm-4.7 zai-org-glm-5 qwen3-vl-235b-a22b Los IDs de modelo son estables. Si hay un cambio disruptivo, lanzaremos un nuevo ID de modelo (por ejemplo, añadiendo una versión como v2). Si no hay cambios disruptivos, podemos actualizar el modelo existente y comunicaremos los cambios significativos. Para ofrecer flexibilidad, Venice también mantiene aliases simbólicos, implementados mediante características, que apuntan al modelo predeterminado recomendado para una tarea dada:
Las características ofrecen una abstracción estable para seleccionar modelos al tiempo que dan a Venice flexibilidad para mejorar la implementación subyacente. Los desarrolladores que prefieren acceso automático a los modelos recomendados más recientes pueden confiar en aliases basados en características. Para aplicaciones que requieren coherencia estricta y comportamiento predecible, recomendamos referenciar IDs de modelo fijos.

​
Feedback

Puedes enviar tu feedback o solicitud a través de nuestro portal de Featurebase. Mantenemos un changelog público, un tracker de roadmap y una justificación transparente para añadir, actualizar o eliminar modelos, y fomentamos la participación continua de la comunidad.

​
Tracker de deprecación de modelos

Los siguientes modelos están programados para deprecación o han sido deprecados recientemente. Recomendamos migrar a los reemplazos sugeridos antes de la fecha de retirada. Los modelos permanecen listados durante 30 días después de su fecha de retirada.

​
Comprobar el estado de deprecación a través de la API

Puedes comprobar si un modelo está programado para retirada llamando al endpoint List Models. Los modelos con una fecha de retirada incluyen un objeto deprecation en su 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"
}
El objeto deprecation solo aparece cuando un modelo está programado para retirada. Puedes comprobar if (model.model_spec.deprecation) para saber si un modelo se está retirando, y usar la fecha ISO 8601 para advertir a los usuarios o planificar migraciones.