Microsoft Foundry SDKs and Endpoints

The Azure AI Projects client library for Python is a unified library that enables you to use multiple client libraries together by connecting to a single project endpoint.

pip install azure-ai-projects azure-identity openai

pip install --pre azure-ai-projects
pip install azure-identity openai

The Azure AI Projects client library for Java (preview) is a unified library that enables you to use multiple client libraries together by connecting to a single project endpoint.

Add these packages to your installation:

• com.azure.ai.projects
• com.azure.core

The Azure AI Projects client library for JavaScript is a unified library that enables you to use multiple client libraries together by connecting to a single project endpoint.

npm install @azure/ai-projects @azure/identity

npm install @azure/ai-projects@beta @azure/identity

The Azure AI Projects client library for .NET is a unified library that enables you to use multiple client libraries together by connecting to a single project endpoint.

Run this command to add the Azure.AI.Projects package to your .NET project.

dotnet add package Azure.AI.Projects --version 1.2

Create a project client:

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

project = AIProjectClient(
  endpoint="https://<resource-name>.services.ai.azure.com/api/projects/<project-name>",
  credential=DefaultAzureCredential())

Create an OpenAI-compatible client from your project:

openai_client = project.inference.get_azure_openai_client(api_version="2024-10-21")
response = openai_client.responses.create(
    model="gpt-5.2",
    input="What is the speed of light?",
)
print(response.output_text)

Create a project client:

import com.azure.ai.projects.ProjectsClient;
import com.azure.ai.projects.ProjectsClientBuilder;
import com.azure.identity.DefaultAzureCredentialBuilder;

String endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";

ProjectsClient projectClient = new ProjectsClientBuilder()
    .credential(new DefaultAzureCredentialBuilder().build())
    .endpoint(endpoint)
    .buildClient();

Create an OpenAI-compatible client from your project:

OpenAIClient openAIClient = projectClient.getOpenAIClient();

Create a project client:

import { AIProjectClient } from '@azure/ai-projects';
import { DefaultAzureCredential } from '@azure/identity';

const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());

Create an OpenAI-compatible client from your project:

const openAIClient = await project.getOpenAIClient();

Create a project client:

using Azure.AI.Projects.OpenAI; 
using Azure.Identity;
using OpenAI.Responses;

string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";

AIProjectClient projectClient = new(
    endpoint: new Uri(endpoint), 
    tokenProvider: new DefaultAzureCredential());

Create an OpenAI-compatible client from your project:

#pragma warning disable OPENAI001
OpenAIResponseClient responseClient = projectClient.OpenAI.GetProjectResponsesClientForModel("gpt-5.2");
OpenAIResponse response = responseClient.CreateResponse("What is the speed of light?");
Console.WriteLine(response.GetOutputText());
#pragma warning restore OPENAI001

This snippet retrieves an OpenAIClient from the ProjectsClient so you can send OpenAI requests through Foundry.

OpenAIClient openAIClient = projectClient.getOpenAIClient();

This snippet uses the project client to create an OpenAI client you can reuse across requests.

// Use the AIProjectClient to create an OpenAI client for your project
const openAIClient = await project.getOpenAIClient();

1. Install the OpenAI package:

   Run this command to add the OpenAI client library to your .NET project.

   dotnet add package OpenAI
   

When it succeeds, the .NET CLI confirms that it installed the OpenAI package.

1. The following code snippet demonstrates how to create the OpenAI client directly using the Azure OpenAI v1 endpoint.

   This snippet configures DefaultAzureCredential, builds OpenAIClientOptions, and creates a ResponseClient for the Azure OpenAI v1 endpoint.

   using Azure.Identity;
   using Azure.Core;
   using OpenAI;
   using System;
   using System.ClientModel.Primitives;
   
   #pragma warning disable OPENAI001
   
   const string directModelEndpoint  = "https://<resource-name>.openai.azure.com/openai/v1/";
   const string deploymentName = "gpt-5.2";    
   
   BearerTokenPolicy tokenPolicy = new(
       new DefaultAzureCredential(),
       "https://cognitiveservices.azure.com/.default");
   
   OpenAIResponseClient client = new(
       model: deploymentName,
       authenticationPolicy: tokenPolicy, // To use Entra 
    // credential: new ApiKeyCredential("<YOUR-AZURE-OPENAI-API-KEY>") // To use APIKEY 
       options: new OpenAIClientOptions()
       {
           Endpoint = new($"{directModelEndpoint}"),
       });
   ResponseCreationOptions options = new ResponseCreationOptions
   {
       Temperature = (float)0.7,
   };
   
   OpenAIResponse modelDirectResponse = client.CreateResponse(
        [
           ResponseItem.CreateUserMessageItem("What is the size of France in square miles?"),
        ], options);
   
   Console.WriteLine($"[ASSISTANT]: {modelDirectResponse.GetOutputText()}");
   #pragma warning restore OPENAI001
   // The ResponseClient lets you interact with models and services in your project.
   

C# supported Foundry Tools

Foundry Tool	Description	Quickstarts and reference documentation
Speech	Add speech to text, text to speech, translation, and speaker recognition capabilities to applications.	• Speech to text quickstart • Text to speech quickstart • Speech translation quickstart • Speech SDK for .NET • Speech NuGet package (Speech CLI)
Language	Build applications with natural language understanding capabilities.	• Custom question answering (CQA) quickstart • Entity linking quickstart • Language detection quickstart • Key Phrase extraction quickstart • Detecting named entities (NER) quickstart • Detect Personally Identifiable Information (PII) quickstart • Sentiment analysis and opinion mining quickstart • Using text, document and conversation summarization quickstart • Using Text Analytics for health quickstart • Language SDK for .NET (text analysis) • Language NuGet package (text analysis) • Language SDK for .NET (Question Answering) • Language NuGet package (question answering)
Translator	Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects.	• Translator SDK for .NET (text) • Translator NuGet package (text) • Translator SDK for .NET (batch) • Translator NuGet package (batch)
Azure AI Search	Bring AI-powered cloud search to your mobile and web apps.	• Use agentic retrieval quickstart • Vector search quickstart • Classic generative search (RAG) using grounding data quickstart • Full-text search quickstart • Semantic ranking quickstart • Chat with Azure OpenAI models using your own data quickstart • Azure AI Search SDK for .NET • Azure AI Search NuGet package
Content Safety	Detect harmful content in applications and services.	• Analyze text content quickstart • Use a text blocklist quickstart • Analyze image content quickstart • Content Safety SDK for .NET • Content Safety NuGet package
Document Intelligence	Turn documents into intelligent data-driven solutions.	• Document Intelligence quickstart • Document Intelligence SDK for .NET • Document Intelligence NuGet package
Vision	Analyze content in digital images and rich media assets.	• Azure Vision in Foundry Tools v3.2 GA Read quickstart • Image Analysis quickstart • Use the Face service quickstart • Vision SDK for .NET • Vision NuGet package

Java supported Foundry Tools

Foundry Tool	Description	Quickstarts and reference documentation
Speech	Add speech to text, text to speech, translation, and speaker recognition capabilities to applications.	• Speech to text quickstart • Text to speech quickstart • Speech translation quickstart • Speech SDK for Java • Speech Maven package
Language	Build applications with natural language understanding capabilities.	• Entity linking quickstart • Language detection quickstart • Key Phrase extraction quickstart • Detecting named entities (NER) quickstart • Detect Personally Identifiable Information (PII) quickstart • Sentiment analysis and opinion mining quickstart • Using text, document and conversation summarization quickstart • Using Text Analytics for health quickstart • Language SDK for Java (text analysis) • Language Maven package
Translator	Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects.	• Translator SDK for Java (text) • Translator Maven package (text)
Azure AI Search	Bring AI-powered cloud search to your mobile and web apps.	• Use agentic retrieval quickstart • Vector search quickstart • Classic generative search (RAG) using grounding data quickstart • Full-text search quickstart • Semantic ranking quickstart • Chat with Azure OpenAI models using your own data quickstart • Azure AI Search SDK for Java • Azure AI Search Maven package
Content Safety	Detect harmful content in applications and services.	• Analyze text content quickstart • Use a text blocklist quickstart • Analyze image content quickstart • Content Safety SDK for Java • Content Safety Maven package
Document Intelligence	Turn documents into intelligent data-driven solutions.	• Document Intelligence quickstart • Document Intelligence SDK for Java • Document Intelligence Maven package
Vision	Analyze content in digital images and rich media assets.	• Image Analysis quickstart • Use the Face service quickstart • Vision SDK for Java • Vision Maven package

JavaScript supported Foundry Tools

Foundry Tool	Description	Reference documentation
Speech	Add speech to text, text to speech, translation, and speaker recognition capabilities to applications.	• Speech to text quickstart • Text to speech quickstart • Speech translation quickstart • Speech SDK for JavaScript • Speech npm package
Language	Build applications with natural language understanding capabilities.	• Entity linking quickstart • Language detection quickstart • Key Phrase extraction quickstart • Detecting named entities (NER) quickstart • Detect Personally Identifiable Information (PII) quickstart • Sentiment analysis and opinion mining quickstart • Using text, document and conversation summarization quickstart • Using Text Analytics for health quickstart • Language SDK for JavaScript (text analysis) • Language npm package
Translator	Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects.	• Translator SDK for JavaScript (text) • Translator npm package (text)
Azure AI Search	Bring AI-powered cloud search to your mobile and web apps.	• Use agentic retrieval quickstart • Vector search quickstart • Classic generative search (RAG) using grounding data quickstart • Full-text search quickstart • Semantic ranking quickstart • Chat with Azure OpenAI models using your own data quickstart • Azure AI Search SDK for JavaScript • Azure AI Search npm package
Content Safety	Detect harmful content in applications and services.	• Analyze text content quickstart • Use a text blocklist quickstart • Analyze image content quickstart • Content Safety npm package
Document Intelligence	Turn documents into intelligent data-driven solutions.	• Document Intelligence quickstart • Document Intelligence SDK for JavaScript • Document Intelligence npm package
Vision	Analyze content in digital images and rich media assets.	• Azure Vision in Foundry Tools v3.2 GA Read quickstart • Image Analysis quickstart • Use the Face service quickstart • Vision SDK for JavaScript • Vision npm package

Python supported Foundry Tools

Foundry Tool	Description	Quickstarts and reference documentation
Speech	Add speech to text, text to speech, translation, and speaker recognition capabilities to applications.	• Speech to text quickstart • Text to speech quickstart • Speech translation quickstart • Speech SDK for Python • Speech PyPi package
Language	Build applications with natural language understanding capabilities.	• Custom question answering (CQA) quickstart • Entity linking quickstart • Language detection quickstart • Key Phrase extraction quickstart • Detect named entities (NER) quickstart • Detect Personally Identifiable Information (PII) quickstart • Sentiment analysis and opinion mining quickstart • Using text, document and conversation summarization quickstart • Using Text Analytics for health quickstart • Language SDK for Python (text analysis) • Language PyPi package (text analysis) • Language SDK for Python (question answering) • Language PyPi package (question answering) • Language SDK for Python (language conversations) • Language PyPi package (language conversations)
Translator	Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects.	• Translator SDK for Python (text) • Translator PyPi package (text) • Translator SDK for Python (batch) • Translator PyPi package (batch)
Azure AI Search	Bring AI-powered cloud search to your mobile and web apps.	• Connect to a search service quickstart • Use agentic retrieval quickstart • Vector search quickstart • Classic generative search (RAG) using grounding data quickstart • Full-text search quickstart • Semantic ranking quickstart • Chat with Azure OpenAI models using your own data quickstart • Azure AI Search SDK for Python • Azure AI Search PyPi package
Content Safety	Detect harmful content in applications and services.	• Analyze text content quickstart • Use a text blocklist quickstart • Analyze image content quickstart • Content Safety SDK for Python • Content Safety PyPi package
Document Intelligence	Turn documents into intelligent data-driven solutions.	• Document Intelligence quickstart • Document Intelligence SDK for Python • Document Intelligence PyPi package
Vision	Analyze content in digital images and rich media assets.	• Azure Vision in Foundry Tools v3.2 GA Read quickstart • Image Analysis quickstart • Use the Face service quickstart • Vision SDK for Python • Vision PyPi package