Ciclo de vida de la versión preliminar de la API de Azure OpenAI

Artículo
01/13/2025

Este artículo le ayudará a comprender el ciclo de vida de soporte técnico de las versiones preliminares de la API de Azure OpenAI. Las nuevas API de versión preliminar tienen como destino una cadencia de versión mensual. Siempre que sea posible, se recomienda usar las versiones más recientes de disponibilidad general o de la versión preliminar de la API.

Nota:

Se pueden agregar nuevos objetos de respuesta de API a la respuesta de API sin cambios en la versión. Se recomienda analizar solo los objetos de respuesta que necesite.

Versiones preliminares de la API más reciente

Versión más reciente de la API de Azure OpenAI:

Inferencia: 2024-12-01-preview
Creación: 2024-10-01-preview

Importante

En el caso de las características que forman parte de la API de creación del plan de datos, como los archivos batch, fine-tuning y assistants, siga usando la versión de API 2024-10-01-preview para aprovechar las características de versión preliminar más recientes.

Esta versión contiene compatibilidad con las características más recientes de Azure OpenAI, entre las que se incluyen:

Modelos de razonamiento [Agregados en 2024-12-01-preview]
Finalizaciones y destilaciones almacenadas [Agregadas en 2024-12-01-preview]
Asistentes V2 [agregados en 2024-05-01-preview]
Parámetros de incrustaciones encoding_format y dimensions [Agregados en 2024-03-01-preview]
API de asistentes. [Agregado en 2024-02-15-preview]
Texto a voz. [Agregado en 2024-02-15-preview]
DALL-E 3. [Agregado el 2023-12-01-preview]
Ajuste de los modelos gpt-35-turbo, babbage-002 y davinci-002. [Agregado en 2023-10-01-preview]
Susurro. [Agregado en 2023-09-01-preview]
Función de llamada [Agregado en 2023-07-01-preview]
Generación aumentada de recuperación con la característica de datos. [Agregado en 2023-06-01-preview]

Cambios entre 2024-12-01-preview y 2024-10-01-preview

Parámetros store y metadata agregados para la compatibilidad con finalizaciones almacenadas.
Se ha agregado reasoning_effort para los modelos de razonamiento más recientes.
Se ha agregado user_security_context para la integración de Microsoft Defender for Cloud.

Cambios entre 2024-09-01-preview y 2024-08-01-preview

Se ha agregado max_completion_tokens para admitir modelos o1-preview y o1-mini. max_tokens no funciona con los modelos de la serie o1.
parallel_tool_calls agregados.
Se agregó completion_tokens_details y reasoning_tokens.
Se agregó stream_options y include_usage.

Cambios entre la especificación de API 2024-07-01-preview y 2024-08-01-preview

Soporte de las salidas estructuradas.
Se ha agregado la API de carga de archivos grandes.
En los cambios de datos:
- Integración de Mongo DB.
- El parámetro role_information se ha eliminado.
- Se ha agregado rerank_score al objeto de cita.
- Se ha quitado el origen de datos de AML.
- Mejoras en la integración de vectorización de Búsqueda de IA.

Cambios entre la especificación de API 2024-5-01-preview y 2024-07-01-preview

Compatibilidad con Batch API agregada
Parámetros de estrategia de fragmentación del almacén de vectores
max_num_results que la herramienta de búsqueda de archivos debe generar.

Cambios entre la especificación de API 2024-04-01-preview y 2024-05-01-preview

Compatibilidad con la versión v2 de los asistentes: Herramienta de búsqueda de archivos y almacenamiento de vectores
Ajuste de puntos de control, inicialización y eventos
En las actualizaciones de los datos
DALL-E 2 ahora admite la implementación de modelos y se puede usar con la API en versión preliminar más reciente.
Actualizaciones en el filtro de contenido

Cambios entre la especificación de API 2024-03-01-preview y 2024-04-01-preview

Cambio importante: se han quitado los parámetros de mejoras. Esto afecta al modelo de gpt-4 Versión: vision-preview
Parámetro timestamp_granularities agregado.
audioWord objeto agregado.
TTS adicional response_formats: wav y pcm.

Versión más reciente de la API de disponibilidad general

La versión de la API de Azure OpenAI 21-10-2024 es actualmente la versión más reciente de la API de disponibilidad general. Esta versión de API es el reemplazo de la versión anterior de la API de 2024-06-01 de disponibilidad general.

Actualización de las versiones de API

Se recomienda probar primero la actualización a las nuevas versiones de la API para confirmar que no hay ningún impacto en la aplicación desde la actualización de la API, antes de realizar el cambio global en todo el entorno.

Si usa las bibliotecas cliente de JavaScript o Python de OpenAI o la API de REST, deberá actualizar el código directamente a la versión preliminar más reciente de la API.

Si usa uno de los SDK de Azure OpenAI para C#, Go o Java, deberá actualizar su entorno a la versión más reciente del SDK. Cada versión del SDK está protegida para trabajar con versiones específicas de la API de Azure OpenAI.

Compartir vía