Azure OpenAI en microsoft Foundry Models v1 API

En este artículo se muestra cómo usar la API de OpenAI v1 Azure. La API v1 simplifica la autenticación, elimina la necesidad de parámetros con fecha api-version y admite llamadas de modelo entre proveedores.

Nota:

Es posible que se agreguen nuevos objetos de respuesta de API a la respuesta de api en cualquier momento. Se recomienda analizar solo los objetos de respuesta que necesite.

Prerrequisitos

Una suscripción Azure: Crear una gratuita
Un recurso Foundry o recurso OpenAI de Azure implementado en una región admitida
Al menos una implementación de modelos
Para la autenticación de Microsoft Entra ID: el rol Cognitive Services OpenAI User asignado a su identidad. Para obtener más información, consulte Control de acceso basado en roles para Azure OpenAI

Evolución de la API

Anteriormente, Azure OpenAI recibió actualizaciones mensuales de nuevas versiones de API. Aprovechar las nuevas características necesarias para actualizar constantemente el código y las variables de entorno con cada nueva versión de API. Azure OpenAI también requería el paso adicional de usar Azure clientes específicos que crearon sobrecarga al migrar código entre OpenAI y Azure OpenAI.

A partir de agosto de 2025, puede suscribirse a la próxima generación de las APIs de Azure OpenAI v1 que añaden compatibilidad con:

Acceso continuo a las características más recientes sin necesidad de especificar nuevas api-version todos los meses.
Ciclo de lanzamiento de API más rápido con nuevas características que se inician con más frecuencia.
Soporte para clientes de OpenAI con cambios mínimos en el código para alternar entre OpenAI y Azure OpenAI al usar la autenticación basada en claves.
Compatibilidad con el cliente de OpenAI para la autenticación basada en tokens y la actualización automática de tokens sin necesidad de depender de un cliente de OpenAI independiente Azure.
Realice llamadas de finalización de chat con modelos de otros proveedores, como DeepSeek y Grok, que admiten la sintaxis de finalizaciones de chat v1.

El acceso a las nuevas llamadas a la API que todavía están en versión preliminar se controlará pasando encabezados de vista previa específicos de características, lo que le permite optar por las funciones que desea, sin tener que intercambiar versiones de la API. Como alternativa, algunas características indicarán el estado de vista previa a través de su ruta de acceso de API y no requieren un encabezado adicional.

Ejemplos:

Cuando /openai/v1/evals se encontraba anteriormente en versión preliminar, era necesario pasar un encabezado "aoai-evals":"preview". /evals ya no está en versión preliminar.
/openai/v1/fine_tuning/alpha/graders/ está en versión preliminar y no requiere ningún encabezado personalizado debido a la presencia de alpha en la ruta de acceso de la API.

Para el lanzamiento inicial de la API v1 de disponibilidad general, solo se admite un subconjunto de las funcionalidades de inferencia y autoría de la API. Todas las características de disponibilidad general se admiten para su uso en producción. La compatibilidad con más funcionalidades se agrega rápidamente.

Cambios en el código

API v1

Ejemplos de Python v1

Clave de API:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),
    base_url="https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/"
)

response = client.responses.create(   
  model="gpt-4.1-nano", # Replace with your model deployment name 
  input="This is a test.",
)

print(response.model_dump_json(indent=2))

Diferencias clave de la API anterior:

OpenAI() el cliente se usa en lugar de AzureOpenAI().
base_url pasa al punto de conexión de OpenAI de Azure y /openai/v1 se añade a la dirección del punto de conexión.
api-version ya no es un parámetro necesario con la API de disponibilidad general v1.

Clave de API con variables de entorno:

Establezca las siguientes variables de entorno antes de ejecutar el código:

Variable	Importancia
`OPENAI_BASE_URL`	`https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/`
`OPENAI_API_KEY`	La clave de API de OpenAI de Azure

A continuación, cree el cliente sin parámetros:

client = OpenAI()

Microsoft Entra ID:

Importante

El control de la actualización automática de tokens se controló previamente mediante el uso del AzureOpenAI() cliente. La API v1 quita esta dependencia al agregar compatibilidad con la actualización automática de tokens al cliente de OpenAI().

from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

client = OpenAI(  
  base_url = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",  
  api_key = token_provider  
)

response = client.responses.create(
    model="gpt-4.1-nano",
    input= "This is a test" 
)

print(response.model_dump_json(indent=2))

base_url pasa al punto de conexión de OpenAI de Azure y /openai/v1 se añade a la dirección del punto de conexión.
El parámetro api_key se establece en token_provider, lo que permite la recuperación automática y la actualización de un token de autenticación en lugar de usar una clave de API estática.

API v1

Ejemplos de C# v1

Clave de API:

OpenAIClient client = new(
    new ApiKeyCredential("{your-api-key}"),
    new OpenAIClientOptions()
    {
        Endpoint = new("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/"),
    })

Microsoft Entra ID:

#pragma warning disable OPENAI001

BearerTokenPolicy tokenPolicy = new(
    new DefaultAzureCredential(),
    "https://ai.azure.com/.default");
OpenAIClient client = new(
    authenticationPolicy: tokenPolicy,
    options: new OpenAIClientOptions()
    {
        Endpoint = new("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/"),
    })

API v1

Ejemplos de JavaScript v1

Clave de API:

const client = new OpenAI({
    baseURL: "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",
    apiKey: "{your-api-key}" 
});

Clave de API con variables de entorno establecidas para OPENAI_BASE_URL y OPENAI_API_KEY:

const client = new OpenAI();

Microsoft Entra ID:

const tokenProvider = getBearerTokenProvider(
    new DefaultAzureCredential(),
    'https://ai.azure.com/.default');
const client = new OpenAI({
    baseURL: "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",
    apiKey: tokenProvider
});

API v1

Ejemplos de Go v1

Clave de API:

client := openai.NewClient(
    option.WithBaseURL("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/"),
    option.WithAPIKey("{your-api-key}")
)

Clave de API con variables de entorno establecidas para OPENAI_BASE_URL y OPENAI_API_KEY:

client := openai.NewClient()

Microsoft Entra ID:

tokenCredential, err := azidentity.NewDefaultAzureCredential(nil)

client := openai.NewClient(
    option.WithBaseURL("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/"),
    azure.WithTokenCredential(tokenCredential)
)

Ejemplos de Java v1

API v1

Clave de API:


OpenAIClient client = OpenAIOkHttpClient.builder()
                .baseUrl("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/")
                .apiKey(apiKey)
                .build();

Clave de API con variables de entorno establecidas para OPENAI_BASE_URL y OPENAI_API_KEY:

OpenAIClient client = OpenAIOkHttpClient.builder()
                .fromEnv()
                .build();

Microsoft Entra ID:

Credential tokenCredential = BearerTokenCredential.create(
        AuthenticationUtil.getBearerTokenSupplier(
                new DefaultAzureCredentialBuilder().build(),
                "https://ai.azure.com/.default"));
OpenAIClient client = OpenAIOkHttpClient.builder()
        .baseUrl("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/")
        .credential(tokenCredential)
        .build();

API v1

Clave de API:

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/responses \
  -H "Content-Type: application/json" \
  -H "api-key: $AZURE_OPENAI_API_KEY" \
  -d '{
     "model": "gpt-4.1-nano",
     "input": "This is a test"
    }'

Microsoft Entra ID:

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AZURE_OPENAI_AUTH_TOKEN" \
  -d '{
     "model": "gpt-4o",
     "input": "This is a test"
    }'

Compatibilidad con los modelos

Para Azure modelos de OpenAI, se recomienda usar la API de Responses, sin embargo, la API v1 también le permite realizar llamadas de finalización de chat con modelos de otros proveedores, como DeepSeek y Grok, que admiten la sintaxis de finalizaciones de chat de OpenAI v1.

base_url aceptará los formatos https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/ y https://YOUR-RESOURCE-NAME.services.ai.azure.com/openai/v1/.

Nota:

La API de respuestas también funciona con los modelos foundry vendidos directamente por Azure, como los modelos microsoft AI, DeepSeek y Grok. Para obtener información sobre cómo usar la API de respuestas con estos modelos, consulte Cómo generar respuestas de texto con modelos de Microsoft Foundry.

from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

client = OpenAI(  
  base_url = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",  
  api_key=token_provider,
)
completion = client.chat.completions.create(
  model="MAI-DS-R1", # Replace with your model deployment name.
  messages=[
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Tell me about the attention is all you need paper"}
  ]
)

#print(completion.choices[0].message)
print(completion.model_dump_json(indent=2))

using Azure.Identity;
using OpenAI;
using OpenAI.Chat;
using System.ClientModel.Primitives;

#pragma warning disable OPENAI001

BearerTokenPolicy tokenPolicy = new(
    new DefaultAzureCredential(),
    "https://ai.azure.com/.default");

ChatClient client = new(
    model: "MAI-DS-R1", // Replace with your model deployment name.
    authenticationPolicy: tokenPolicy,
    options: new OpenAIClientOptions() { 
    
        Endpoint = new Uri("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1")
   }
);

ChatCompletion completion = client.CompleteChat("Tell me about the attention is all you need paper");

Console.WriteLine($"[ASSISTANT]: {completion.Content[0].Text}");

import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";
import { OpenAI } from "openai";

const tokenProvider = getBearerTokenProvider(
    new DefaultAzureCredential(),
    'https://ai.azure.com/.default');
const client = new OpenAI({
    baseURL: "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",
    apiKey: tokenProvider
});

const messages = [
    { role: 'system', content: 'You are a helpful assistant.' },
    { role: 'user', content: 'Tell me about the attention is all you need paper' }
];

// Make the API request with top-level await
const result = await client.chat.completions.create({ 
    messages, 
    model: 'MAI-DS-R1', // model deployment name
    max_tokens: 100 
});

// Print the full response
console.log('Full response:', result);

// Print just the message content from the response
console.log('Response content:', result.choices[0].message.content);


package main

import (
	"context"
	"fmt"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/openai/openai-go/v3"
	"github.com/openai/openai-go/v3/azure"
	"github.com/openai/openai-go/v3/option"
)

func main() {
	// Create an Azure credential
	tokenCredential, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("Failed to create credential: %s", err)
	}

	// Create a client with Azure OpenAI endpoint and token credential
	client := openai.NewClient(
		option.WithBaseURL("https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/"),
		azure.WithTokenCredential(tokenCredential),
	)

	// Make a completion request
	chatCompletion, err := client.Chat.Completions.New(context.TODO(), openai.ChatCompletionNewParams{
		Messages: []openai.ChatCompletionMessageParamUnion{
			openai.UserMessage("Explain what the bitter lesson is?"),
		},
		Model: "MAI-DS-R1", // Use your deployed model name on Azure
	})
	if err != nil {
		log.Fatalf("Failed to get chat completions: %s", err)
	}

	fmt.Println(chatCompletion.Choices[0].Message.Content)
}

package com.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.ChatModel;
import com.openai.models.chat.completions.ChatCompletion;
import com.openai.models.chat.completions.ChatCompletionCreateParams;

public class OpenAITest {
    public static void main(String[] args) {
        // Get API key from environment variable for security
        String apiKey = System.getenv("OPENAI_API_KEY");
        String resourceName = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1";
        String modelDeploymentName = "MAI-DS-R1"; //replace with your model deployment name

        try {
            OpenAIClient client = OpenAIOkHttpClient.builder()
                    .baseUrl(resourceName)
                    .apiKey(apiKey)
                    .build();

           ChatCompletionCreateParams params = ChatCompletionCreateParams.builder()
              .addUserMessage("Explain what the bitter lesson is?")
              .model(modelDeploymentName)
              .build();
           ChatCompletion chatCompletion = client.chat().completions().create(params);
        }
    }
}

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AZURE_OPENAI_AUTH_TOKEN" \
  -d '{
      "model": "MAI-DS-R1",
      "messages": [
      {
        "role": "developer",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "Explain what the bitter lesson is?"
      }
    ]
  }'

Compatibilidad con la API v1

v1 Especificación OpenAPI 3.0

Registro de cambios de la versión de API

En las secciones siguientes se resumen los cambios entre las versiones de API.

Cambios entre la versión preliminar v1 y 2025-04-01-preview

API de versión preliminar v1
Compatibilidad con la generación de vídeos
NUEVO Características de la API de respuestas:
- Integración de herramientas con el servidor de Protocolo de Contexto de Modelo Remoto (MCP)
- Compatibilidad con tareas en segundo plano asincrónicas
- Elementos de razonamiento cifrados
- Generación de imágenes

Cambios entre 2025-04-01-preview y 2025-03-01-preview

soporte GPT-image-1
Resumen de razonamiento para o3 y o4-mini
API de Evaluación

Cambios entre 2025-03-01-preview y 2025-02-01-preview

API de respuestas
Uso del equipo

Cambios entre 2025-02-01-preview y 2025-01-01-preview

Finalizaciones almacenadas (compatibilidad con la API de destilación).

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

Parámetro prediction agregado para la compatibilidad con salidas previstas.
gpt-4o-audio-preview Compatibilidad con los modelos.

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

store y metadata parámetros agregados para el soporte de finalizaciones almacenadas.
Se ha agregado reasoning_effort para los modelos de razonamiento más recientes.
Se ha añadido 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 agregado.
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.
- rerank_score agregado 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-05-01-preview y 2024-07-01-preview

compatibilidad con Batch API agregada
Vector almacenan parámetros de estrategia de fragmentación
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 asistentes v2: 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-4Versión:vision-preview
timestamp_granularities parámetro agregado.
audioWord objeto agregado.
TTS adicional response_formats: wav & pcm.

Problemas conocidos

La especificación de 2025-04-01-preview Azure OpenAI utiliza OpenAPI 3.1. Es un problema conocido que esta versión no es totalmente compatible con Azure API Management.

Pasos siguientes

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-03-20

Compartir a través de

Azure OpenAI en microsoft Foundry Models v1 API

Prerrequisitos

Evolución de la API

Cambios en el código

API v1

Compatibilidad con los modelos

Compatibilidad con la API v1

Registro de cambios de la versión de API

Cambios entre la versión preliminar v1 y 2025-04-01-preview

Cambios entre 2025-04-01-preview y 2025-03-01-preview

Cambios entre 2025-03-01-preview y 2025-02-01-preview

Cambios entre 2025-02-01-preview y 2025-01-01-preview

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

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

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

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

Cambios entre la especificación de api 2024-05-01-preview y 2024-07-01-preview

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

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

Problemas conocidos

Pasos siguientes

Comentarios

Recursos adicionales