Azure OpenAI im Lebenszyklus der Azure AI Foundry Models API

Dieser Artikel soll Ihnen helfen, den Supportlebenszyklus für Azure OpenAI-APIs zu verstehen.

Hinweis

Neue API-Antwortobjekte können der API-Antwort ohne Versionsänderungen hinzugefügt werden. Es wird empfohlen, nur die benötigten Antwortobjekte zu parsen.

Die 2025-04-01-preview Azure OpenAI-Spezifikation verwendet OpenAPI 3.1, ist ein bekanntes Problem, das derzeit nicht vollständig von Azure API Management unterstützt wird.

API-Entwicklung

In der Vergangenheit erhielt Azure OpenAI monatliche Updates neuer API-Versionen. Durch die Nutzung neuer Features müssen Code- und Umgebungsvariablen ständig mit jeder neuen API-Version aktualisiert werden. Azure OpenAI erforderte auch den zusätzlichen Schritt der Verwendung von Azure-spezifischen Clients, die beim Migrieren von Code zwischen OpenAI und Azure OpenAI Mehraufwand erzeugten. Ab Mai 2025 können Sie sich für unsere nächste Generation von Azure OpenAI-APIs Version 1 anmelden, die Unterstützung für Folgendes hinzufügen:

• Fortlaufender Zugriff auf die neuesten Features, ohne jeden Monat aktualisieren api-version zu müssen.
• OpenAI-Clientunterstützung mit minimalen Codeänderungen für den Austausch zwischen OpenAI und Azure OpenAI bei Verwendung der schlüsselbasierten Authentifizierung.

Für den ersten Vorschaustart unterstützen wir nur eine Teilmenge der Rückschluss-API. Während der Vorschau verfügen Vorgänge möglicherweise über unvollständige Funktionen, die kontinuierlich erweitert werden.

Codeänderungen

API-Schlüssel

API der letzten Generation

import os
from openai import AzureOpenAI

client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
    api_version="2025-04-01-preview",
    azure_endpoint="https://YOUR-RESOURCE-NAME.openai.azure.com")
    )

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)) 

API der nächsten Generation

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/",
    default_query={"api-version": "preview"}, 
)

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)) 

• OpenAI() client wird anstelle von AzureOpenAI() verwendet.
• base_url übergibt den Azure OpenAI-Endpunkt und /openai/v1 wird an die Endpunktadresse angefügt.
• default_query={"api-version": "preview"} gibt an, dass die versionslose, immer aktuelle Vorschau-API verwendet wird.

Sobald wir die GA-API der nächsten Generation v1 veröffentlicht haben, unterstützen wir zwei Werte: latest und preview. Wenn api-version nicht übergeben wird, wird der Datenverkehr automatisch an die latest GA-Version geleitet. Derzeit wird nur preview unterstützt.

Microsoft Entra-ID

API der letzten Generation

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

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

client = AzureOpenAI(
  azure_endpoint = "https://YOUR-RESOURCE-NAME.openai.azure.com/", 
  azure_ad_token_provider=token_provider,
  api_version="2025-04-01-preview"
)

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)) 

API der nächsten Generation

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

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

client = AzureOpenAI(  
  base_url = "https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/",  
  azure_ad_token_provider=token_provider,
  api_version="preview"
)

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

print(response.model_dump_json(indent=2)) 

• AzureOpenAI() wird verwendet, um die automatische Tokenaktualisierung zu nutzen, die durch azure_ad_token_provider bereitgestellt wird.
• base_url übergibt den Azure OpenAI-Endpunkt und /openai/v1 wird an die Endpunktadresse angefügt.
• api-version="preview" gibt an, dass die versionslose, immer aktuelle Vorschau-API verwendet wird.

Sobald wir die GA-API der nächsten Generation v1 veröffentlicht haben, unterstützen wir zwei Werte: latest und preview. Wenn api-version nicht übergeben wird, wird der Datenverkehr automatisch zur latest GA-Version geleitet. Derzeit wird nur preview unterstützt.

PAUSE

API der letzten Generation

API-Schlüssel:

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/responses?api-version=2025-04-01-preview \
  -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/responses?api-version=2025-04-01-preview \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AZURE_OPENAI_AUTH_TOKEN" \
  -d '{
     "model": "gpt-4.1-nano",
     "input": "This is a test"
    }'

API der nächsten Generation

API-Schlüssel:

curl -X POST https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/responses?api-version=preview \
  -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?api-version=preview \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AZURE_OPENAI_AUTH_TOKEN" \
  -d '{
     "model": "gpt-4o",
     "input": "This is a test"
    }'

Ausgabe

{
  "id": "resp_682f7eb5dc408190b491cbbe57be2fbf0f98d661c3dc276d",
  "created_at": 1747943093.0,
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "metadata": {},
  "model": "gpt-4.1-nano",
  "object": "response",
  "output": [
    {
      "id": "msg_682f7eb61d908190926a004c15c5ddd00f98d661c3dc276d",
      "content": [
        {
          "annotations": [],
          "text": "Hello! It looks like you've sent a test message. How can I assist you today?",
          "type": "output_text"
        }
      ],
      "role": "assistant",
      "status": "completed",
      "type": "message"
    }
  ],
  "parallel_tool_calls": true,
  "temperature": 1.0,
  "tool_choice": "auto",
  "tools": [],
  "top_p": 1.0,
  "background": null,
  "max_output_tokens": null,
  "previous_response_id": null,
  "reasoning": {
    "effort": null,
    "generate_summary": null,
    "summary": null
  },
  "service_tier": "default",
  "status": "completed",
  "text": {
    "format": {
      "type": "text"
    }
  },
  "truncation": "disabled",
  "usage": {
    "input_tokens": 12,
    "input_tokens_details": {
      "cached_tokens": 0
    },
    "output_tokens": 19,
    "output_tokens_details": {
      "reasoning_tokens": 0
    },
    "total_tokens": 31
  },
  "user": null,
  "store": true
}

Vorschau API-Veröffentlichungen

Neueste Versionen der Azure OpenAI-API:

• NEUE v1 Preview-API
• Rückschluss: 2025-04-01-preview
• Dokumenterstellung: 2025-04-01-preview

Änderungen zwischen Version 1 Preview und 2025-04-01-preview

• v1 Preview-API

Änderungen zwischen 2025-04-01-Vorschau und 2025-03-01-Preview

• GPT-image-1 Unterstützung
• Zusammenfassung der Gründe für o3 und o4-mini
• Auswertungs-API

Änderungen zwischen 2025-03-01-Vorschau und 2025-02-01-Preview

• Antwort-API-
• Computerverwendung

Änderungen zwischen 2025-02-01-Vorschau und 2025-01-01-Preview

• Unterstützung für die API für gespeicherte Fertigstellungen (Destillation).

Änderungen zwischen 2025-01-01-Vorschau und 2024-12-01-Preview

• prediction Parameter hinzugefügt für Support für prognostizierte Ausgaben.
• gpt-4o-audio-previewModellunterstützung.

Änderungen zwischen 2024-12-01-preview und 2024-10-01-preview

• Parameter store und metadata zur Unterstützung für gespeicherte Vervollständigungen hinzugefügt
• reasoning_effort für die neuesten Reasoning-Modelle hinzugefügt
• user_security_context für die Integration mit Microsoft Defender for Cloud hinzugefügt

Änderungen zwischen 2024-09-01-preview und 2024-08-01-preview

• max_completion_tokens hinzugefügt, um o1-preview- und o1-mini-Modelle zu unterstützen. max_tokens funktioniert nicht mit den Modellen der Serie o1.
• parallel_tool_calls hinzugefügt.
• completion_tokens_details und reasoning_tokens hinzugefügt.
• stream_options und include_usage hinzugefügt.

Änderungen zwischen der API-Spezifikation 2024-07-01-preview und 2024-08-01-preview

• Strukturierte Ausgaben unterstützen.
• API für den Upload großer Dateien hinzugefügt.
• Auf Ihre Datenänderungen:
  • Mongo DB-Integration.
  • Der Parameter role_information wurde entfernt.
  • rerank_score zum Zitatobjekt hinzugefügt.
  • AML-Datenquelle wurde entfernt.
  • Verbesserungen der KI-Suchvektorisierungsintegration.

Änderungen zwischen der API-Spezifikation 2024-5-01-preview und 2024-07-01-preview

• Batch-API-Unterstützung hinzugefügt
• Parameter für die Strategie zur Segmentierung im Vektorspeicher
• max_num_results-Wert, den das Tool für die Dateisuche ausgeben soll.

Änderungen zwischen der API-Spezifikation2024-04-01-preview und 2024-05-01-preview

• Assistenten v2-Unterstützung – Dateisuchtool und Vektorspeicher
• Optimierung Prüfpunkte, Seed, Ereignisse
• Auf Ihren Datenupdates
• DALL-E 2 unterstützt jetzt die Modellbereitstellung und kann mit der neuesten Vorschau-API verwendet werden.
• Aktualisierungen der Inhaltsfilterung

Änderungen zwischen der API-Spezifikation 2024-03-01-Vorschau und 2024-04-01-Vorschau

• Breaking Change: Parameter für Verbesserungen entfernt. Dies wirkt sich auf das Modell der gpt-4Version:vision-preview aus.
• Parameter timestamp_granularities hinzugefügt.
• Objekt audioWord hinzugefügt.
• Zusätzliche TTS response_formats: wav & pcm.

Neueste GA-API-Version

Version 2024-10-21 der Azure OpenAI-API ist derzeit die neueste allgemein verfügbare API-Version. Diese API-Version ersetzt das vorherige GA-API-Release 2024-06-01.

Updaten von API-Versionen

Es wird empfohlen, zuerst das Upgrade auf neue API-Versionen zu testen, um sich zu vergewissern, dass das API-Update keine Auswirkungen auf Ihre Anwendung hat, bevor Sie die Änderung global in Ihrer Umgebung vornehmen.

Wenn Sie die Python- oder JavaScript-Clientbibliotheken von OpenAI oder die REST-API verwenden, müssen Sie Ihren Code direkt auf die neueste API-Vorschauversion aktualisieren.

Wenn Sie eines der Azure OpenAI SDKs für C#, Go oder Java verwenden, müssen Sie stattdessen auf die neueste Version des SDK aktualisieren. Jedes SDK-Release ist für bestimmte Versionen der Azure OpenAI-API hartcodiert.

Nächste Schritte

• Weitere Informationen zu Azure OpenAI
• Informationen zum Arbeiten mit Azure OpenAI-Modellen