Azure OpenAI a Microsoft Foundry Models v1 API-verzióban

Ez a cikk bemutatja, hogyan használhatja az 1-es verziós Azure OpenAI API-t. A v1 API leegyszerűsíti a hitelesítést, megszünteti a dátumozott api-version paraméterek szükségességét, és támogatja a szolgáltatóközi modellhívásokat.

Megjegyzés

Az API-válaszobjektumok bármikor hozzáadhatók az API-válaszhoz. Javasoljuk, hogy csak a szükséges válaszobjektumokat elemezje.

Előfeltételek

• Egy Azure-előfizetés – A előfizetés létrehozása ingyenesen
• Foundry-erőforrás vagy Azure OpenAI-erőforrás egy által támogatott régióban
• Legalább egy modell üzembe helyezése
• Microsoft Entra ID hitelesítéshez: az ön identitásához rendelt Cognitive Services OpenAI User szerepkör. További információ: Role-alapú hozzáférés-vezérlés Azure OpenAI

API-fejlesztés

Korábban Azure OpenAI havi frissítéseket kapott az új API-verziókról. Az új funkciók kihasználása a kód- és környezeti változók folyamatos frissítését igényli minden új API-kiadással. Azure OpenAI-nak szüksége volt a Azure adott ügyfelek használatára is, amelyek többletterhelést hoztak létre a kód OpenAI és Azure OpenAI közötti migrálása során.

2025 augusztusától a következő generációs 1- Azure OpenAI API-k mellett dönthet, amelyek a következőkhöz nyújtanak támogatást:

• Folyamatos hozzáférés a legújabb funkciókhoz, és nem kell minden hónapban új api-versionfunkciókat megadni.
• Gyorsabb API-kiadási ciklus, az új funkciók gyakrabban indulnak el.
• Az OpenAI ügyféltámogatása minimális kódmódosításokkal az OpenAI és Azure OpenAI közötti váltáshoz kulcsalapú hitelesítés esetén.
• OpenAI-ügyféltámogatás jogkivonatalapú hitelesítéshez és automatikus jogkivonat-frissítéshez anélkül, hogy külön Azure OpenAI-ügyfélhez kellene függőséget vállalnia.
• Csevegővégzítési hívásokat kezdeményezhet más szolgáltatók modelljeivel, például a DeepSeek és a Grok használatával, amelyek támogatják a v1-alapú csevegések befejezésének szintaxisát.

A még előzetes verzióban lévő új API-hívásokhoz való hozzáférést a funkcióspecifikus előnézeti fejlécek átadásával szabályozhatja, így az API-verziók felcserélése nélkül választhatja ki a kívánt funkciókat. Másik lehetőségként egyes funkciók az API-elérési útjukon keresztül jelzik az előzetes verzió állapotát, és nem igényelnek további fejlécet.

Példák:

• Amikor /openai/v1/evals korábban előzetes verzióban volt, meg kellett adni egy "aoai-evals":"preview" fejlécet. A /evals már nincs előzetes verzióban.
• /openai/v1/fine_tuning/alpha/graders/ előzetes verzióban érhető el, és nem igényel egyéni fejlécet az API elérési útjának alpha jelenléte miatt.

A kezdeti 1- es általánosan elérhető (GA) API indításakor csak a következtetési és szerzői API-képességek egy részhalmaza támogatott. Az összes ga-funkció támogatott az éles környezetben való használathoz. A további képességek támogatása gyorsan bővül.

Kódmódosítások

Python

v1 API

Python 1. verzió példák

API-kulcs:

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

Főbb különbségek az előző API-tól:

• Az OpenAI() kerül használatra AzureOpenAI() helyett.
• base_url átadja a Azure OpenAI-végpontot, és /openai/v1 hozzá van fűzve a végpontcímhez.
• api-version már nem szükséges paraméter a v1 GA API-val.

API-kulcs környezeti változókkal:

A kód futtatása előtt állítsa be a következő környezeti változókat:

Változó	Érték
OPENAI_BASE_URL	https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/
OPENAI_API_KEY	Az Azure OpenAI API-kulcs

Ezután hozza létre az ügyfelet paraméterek nélkül:

client = OpenAI()

Microsoft Entra-azonosító:

Fontos

Az automatikus jogkivonat-frissítés kezelését korábban az AzureOpenAI() ügyfél használatával kezelték. A v1 API eltávolítja ezt a függőséget, ha automatikus jogkivonat-frissítési támogatást ad hozzá az OpenAI() ügyfélhez.

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 átadja a Azure OpenAI-végpontot, és /openai/v1 hozzá van fűzve a végpontcímhez.
• api_key paramétert token_provider értékre állítva a hitelesítési jogkivonat automatikus lekérését és frissítését teszi lehetővé statikus API-kulcs használata helyett.

C#

v1 API

C# v1 példák

API-kulcs:

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

Microsoft Entra-azonosító:

#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/"),
    })

Javascript

v1 API

JavaScript v1 példák

API-kulcs:

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

API-kulcs a OPENAI_BASE_URLOPENAI_API_KEY környezeti változókkal beállítva:

const client = new OpenAI();

Microsoft Entra-azonosító:

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

Megy

v1 API

1. verziós példák

API-kulcs:

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

API-kulcs a OPENAI_BASE_URLOPENAI_API_KEY környezeti változókkal beállítva:

client := openai.NewClient()

Microsoft Entra-azonosító:

tokenCredential, err := azidentity.NewDefaultAzureCredential(nil)

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

Java

Java v1-példák

v1 API

API-kulcs:

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

API-kulcs a OPENAI_BASE_URLOPENAI_API_KEY környezeti változókkal beállítva:

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

Microsoft Entra-azonosító:

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

REST

v1 API

API-kulcs:

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-azonosító:

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"
    }'

Modelltámogatás

Azure OpenAI-modellek esetében a Responses API használatát javasoljuk, azonban a v1 API lehetővé teszi a csevegések befejezését más szolgáltatók modelljeivel, például a DeepSeek és a Grok használatával, amelyek támogatják az OpenAI v1 csevegés befejezésének szintaxisát.

A base_url elfogadja mind a https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/, mind a https://YOUR-RESOURCE-NAME.services.ai.azure.com/openai/v1/ formátumokat.

Megjegyzés

A Responses API a közvetlenül az Azure által értékesített Foundry modellekkel is működik, mint például a Microsoft AI, DeepSeek és Grok modellekkel. Ha tudni szeretné, hogyan használhatja a Responses API-t ezekkel a modellekkel, olvassa el a A szöveges válaszok Microsoft Öntödei modellek használatával történő létrehozásához című témakört.

Python

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

C#

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}");

Javascript

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

Megy

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

Java

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

REST

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?"
      }
    ]
  }'

v1 API-támogatás

• v1 OpenAPI 3.0 specifikáció

API-verzióváltozási napló

A következő szakaszok összefoglalják az API-verziók közötti változásokat.

Változások az 1. előzetes verzió és a 2025-04-01 előzetes verzió között

• 1- es verziójú előzetes API
• Videógenerálás támogatása
• ÚJ Responses API funkciók:
  • Remote Model Context Protocol (MCP) kiszolgálók eszközintegrálása
  • Aszinkron háttérfeladatok támogatása
  • Titkosított érvelési elemek
  • Képgenerálás

Változások 2025-04-01-preview és 2025-03-01-preview között

• GPT-image-1 Támogatás
• Érvelés összegzése o3 és o4-mini
• Kiértékelési API

Változások 2025. 03. 01. és 2025. 02. 01. között

• Responses API
• Számítógép-használat

Változások 2025-02-01-preview és 2025-01-01-preview között

• Tárolt befejezések (desztillációs API-támogatás).

Változások 2025. 01. 01. és 2024. 12. 01. között

• prediction paraméter hozzáadva az előrejelzett kimenetek támogatásához .
• gpt-4o-audio-preview modelltámogatás.

Változások 2024-12-01-preview és 2024-10-01-preview között

• store és metadata paraméterek hozzáadva a tárolt befejezések támogatásához.
• reasoning_effort hozzáadva a legújabb érvelési modellekhez.
• user_security_context hozzáadva a Microsoft Defender for Cloud integrációhoz.

Változások 2024-09-01-preview és 2024-08-01-preview között

• max_completion_tokens hozzáadva a o1-preview és o1-mini modellek támogatásához. max_tokens nem működik az o1 sorozatú modellekkel.
• parallel_tool_calls Hozzáadott.
• completion_tokens_details & reasoning_tokens hozzáadva.
• stream_options & include_usage hozzáadva.

Változások a 2024-07-01 előzetes verzió és a 2024-08-01 előzetes verziójú API specifikációja között

• Strukturált kimenetek támogatása.
• Nagy méretű fájlfeltöltési API hozzáadva.
• Az Ön adatváltozásai:
  • Mongo DB-integráció.
  • role_information paraméter el lett távolítva.
  • rerank_score hozzáadva az idézetobjektumhoz.
  • Az AML-adatforrás el lett távolítva.
  • Az AI Search vektorizálási integrációjának fejlesztései.

Változások a 2024-05-01 előzetes verzió és a 2024-07-01 előzetes verziójú API-specifikáció között

• Batch API-támogatás hozzáadva
• Vektortároló adattömb-stratégiai paraméterei
• max_num_results a fájlkereső eszköz által kiadott kimenetnek kell lennie.

Változások a 2024-04-01 előzetes verzió és a 2024-05-01 előzetes verziójú API-specifikáció között

• Asszisztensek v2 támogatása – Fájlkereső eszköz és vektoros tárolás
• A checkpoints, seed, events finomhangolása
• Az Ön adatfrissítéseivel kapcsolatban
• DALL-E 2 mostantól támogatja a modell üzembe helyezését, és a legújabb előzetes API-val használható.
• Tartalomszűrési frissítések

Változások a 2024-03-01 előzetes verzió és a 2024-04-01 előzetes verziójú API-specifikáció között

• Kompatibilitástörő változás: A fejlesztési paraméterek eltávolításra kerültek. Ez hatással van a gpt-4Verzió:vision-preview modellre.
• timestamp_granularities paraméter hozzáadva.
• audioWord objektum hozzáadva.
• További TTS response_formats: wav & pcm.

Ismert problémák

• A 2025-04-01-preview Azure OpenAI specifikáció az OpenAPI 3.1-et használja. Ismert probléma, hogy ezt a verziót a Azure API Management nem támogatja teljes mértékben.

Következő lépések

• Támogatott programozási nyelvek a v1 API-hoz
• A Azure
• Az Azure OpenAI-modellekkel való munka
• Azure OpenAI-kvóták és -korlátok
• v1 OpenAPI 3.0 specifikáció