merge

santiagxf · santiagxf · commit 90f324bf8f8b · 2025-05-17T17:10:29.000-04:00
diff --git a/articles/ai-foundry/model-inference/faq.yml b/articles/ai-foundry/model-inference/faq.yml
@@ -17,9 +17,9 @@ sections:
   - name: General
     questions:
       - question: |
-          What's the difference between Azure OpenAI and Foundry Models?
+          What's the difference between Azure OpenAI and Azure AI Foundry Models?
         answer: |
-          Azure OpenAI gives customers access to advanced language models from OpenAI. Foundry Models extends such capability giving customers access to all the flagship models in Azure AI Foundry under the same service, endpoint, and credentials. It includes Azure OpenAI, Cohere, Mistral AI, Meta Llama, AI21 labs, etc. Customers can seamlessly switch between models without changing their code.
+          Azure OpenAI gives customers access to advanced language models from OpenAI. Azure AI Foundry Models extends such capability giving customers access to all the flagship models in Azure AI Foundry under the same service, endpoint, and credentials. It includes Azure OpenAI, Cohere, Mistral AI, Meta Llama, AI21 labs, etc. Customers can seamlessly switch between models without changing their code.
 
           Azure OpenAI is included in the Models Sold Directly by Azure family in Foundry Models.
       - question: |
diff --git a/articles/ai-foundry/model-inference/how-to/use-chat-completions.md b/articles/ai-foundry/model-inference/how-to/use-chat-completions.md
@@ -11,41 +11,26 @@ ms.date: 1/21/2025
 ms.author: mopeakande
 ms.reviewer: fasantia
 ms.custom: generated
-zone_pivot_groups: azure-ai-inference-samples
+zone_pivot_groups: azure-ai-foundry-models-samples
 ---
 
 # How to generate chat completions with Azure AI Foundry Models
 
 
-::: zone pivot="programming-language-python"
+::: zone pivot="api-openai"
 
-[!INCLUDE [python](../includes/use-chat-completions/python.md)]
-::: zone-end
-
-
-::: zone pivot="programming-language-javascript"
+[!INCLUDE [openai](../includes/use-chat-completions/openai.md)]
 
-[!INCLUDE [javascript](../includes/use-chat-completions/javascript.md)]
 ::: zone-end
 
 
-::: zone pivot="programming-language-java"
-
-[!INCLUDE [java](../includes/use-chat-completions/java.md)]
-::: zone-end
+::: zone pivot="api-inference"
 
+[!INCLUDE [inference](../includes/use-chat-completions/inference.md)]
 
-::: zone pivot="programming-language-csharp"
-
-[!INCLUDE [csharp](../includes/use-chat-completions/csharp.md)]
 ::: zone-end
 
 
-::: zone pivot="programming-language-rest"
-
-[!INCLUDE [rest](../includes/use-chat-completions/rest.md)]
-::: zone-end
-
 ## Related content
 
 * [Use embeddings models](use-embeddings.md)
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-completions/inference.md b/articles/ai-foundry/model-inference/includes/use-chat-completions/inference.md
@@ -0,0 +1,43 @@
+---
+manager: scottpolly
+author: msakande
+reviewer: santiagxf
+ms.date: 1/21/2025
+ms.author: mopeakande
+ms.reviewer: fasantia
+zone_pivot_groups: azure-ai-inference-samples
+---
+
+::: zone pivot="programming-language-python"
+
+[!INCLUDE [python](inference/python.md)]
+
+::: zone-end
+
+
+::: zone pivot="programming-language-javascript"
+
+[!INCLUDE [javascript](inference/javascript.md)]
+
+::: zone-end
+
+
+::: zone pivot="programming-language-java"
+
+[!INCLUDE [java](inference/java.md)]
+
+::: zone-end
+
+
+::: zone pivot="programming-language-csharp"
+
+[!INCLUDE [csharp](inference/csharp.md)]
+
+::: zone-end
+
+
+::: zone pivot="programming-language-rest"
+
+[!INCLUDE [rest](inference/rest.md)]
+
+::: zone-end
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/csharp.md b/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/csharp.md
@@ -22,11 +22,11 @@ This article explains how to use chat completions API with models deployed in Az
 
 To use chat completion models in your application, you need:
 
-[!INCLUDE [how-to-prerequisites](../how-to-prerequisites.md)]
+[!INCLUDE [how-to-prerequisites](../../how-to-prerequisites.md)]
 
-[!INCLUDE [how-to-prerequisites-csharp](../how-to-prerequisites-csharp.md)]
+[!INCLUDE [how-to-prerequisites-csharp](../../how-to-prerequisites-csharp.md)]
 
-* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
 
     * This example uses `mistral-large-2407`.
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/java.md b/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/java.md
@@ -22,11 +22,11 @@ This article explains how to use chat completions API with models deployed in Az
 
 To use chat completion models in your application, you need:
 
-[!INCLUDE [how-to-prerequisites](../how-to-prerequisites.md)]
+[!INCLUDE [how-to-prerequisites](../../how-to-prerequisites.md)]
 
-[!INCLUDE [how-to-prerequisites-java](../how-to-prerequisites-java.md)]
+[!INCLUDE [how-to-prerequisites-java](../../how-to-prerequisites-java.md)]
 
-* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
 
     * This example uses `mistral-large-2407`.
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/javascript.md b/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/javascript.md
@@ -22,11 +22,11 @@ This article explains how to use chat completions API with models deployed in Az
 
 To use chat completion models in your application, you need:
 
-[!INCLUDE [how-to-prerequisites](../how-to-prerequisites.md)]
+[!INCLUDE [how-to-prerequisites](../../how-to-prerequisites.md)]
 
-[!INCLUDE [how-to-prerequisites-javascript](../how-to-prerequisites-javascript.md)]
+[!INCLUDE [how-to-prerequisites-javascript](../../how-to-prerequisites-javascript.md)]
 
-* A chat completions model deployment. If you don't have one, read [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
       
 ## Use chat completions
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/python.md b/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/python.md
@@ -22,11 +22,11 @@ This article explains how to use chat completions API with models deployed in Az
 
 To use chat completion models in your application, you need:
 
-[!INCLUDE [how-to-prerequisites](../how-to-prerequisites.md)]
+[!INCLUDE [how-to-prerequisites](../../how-to-prerequisites.md)]
 
-[!INCLUDE [how-to-prerequisites-python](../how-to-prerequisites-python.md)]
+[!INCLUDE [how-to-prerequisites-python](../../how-to-prerequisites-python.md)]
 
-* A chat completions model deployment. If you don't have one, read [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
 
     * This example uses `mistral-large-2407`.
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/rest.md b/articles/ai-foundry/model-inference/includes/use-chat-completions/inference/rest.md
@@ -22,9 +22,9 @@ This article explains how to use chat completions API with models deployed in Az
 
 To use chat completion models in your application, you need:
 
-[!INCLUDE [how-to-prerequisites](../how-to-prerequisites.md)]
+[!INCLUDE [how-to-prerequisites](../../how-to-prerequisites.md)]
 
-* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
 
     * This example uses `mistral-large-2407`.
 
@@ -46,7 +46,7 @@ Content-Type: application/json
 Authorization: Bearer <token>
 ```
 
-Using Microsoft Entra ID might require extra configuration in your resource to grant access. Learn how to [configure key-less authentication with Microsoft Entra ID](../../how-to/configure-entra-id.md).
+Using Microsoft Entra ID might require extra configuration in your resource to grant access. Learn how to [configure key-less authentication with Microsoft Entra ID](../../../how-to/configure-entra-id.md).
 
 ### Create a chat completion request
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-completions/openai.md b/articles/ai-foundry/model-inference/includes/use-chat-completions/openai.md
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-multi-modal/csharp.md b/articles/ai-foundry/model-inference/includes/use-chat-multi-modal/csharp.md
@@ -26,7 +26,7 @@ To use chat completion models in your application, you need:
 
 [!INCLUDE [how-to-prerequisites-csharp](../how-to-prerequisites-csharp.md)]
 
-* A chat completions model deployment. If you don't have one, read [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment. If you don't have one, read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
 
     * This example uses `phi-4-multimodal-instruct`.
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-multi-modal/java.md b/articles/ai-foundry/model-inference/includes/use-chat-multi-modal/java.md
@@ -24,7 +24,7 @@ To use chat completion models in your application, you need:
 
 [!INCLUDE [how-to-prerequisites-java](../how-to-prerequisites-java.md)]
 
-* A chat completions model deployment. If you don't have one read [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment. If you don't have one read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
 
     * This example uses `phi-4-multimodal-instruct`.
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-multi-modal/javascript.md b/articles/ai-foundry/model-inference/includes/use-chat-multi-modal/javascript.md
@@ -25,7 +25,7 @@ To use chat completion models in your application, you need:
 
 [!INCLUDE [how-to-prerequisites-javascript](../how-to-prerequisites-javascript.md)]
 
-* A chat completions model deployment with support for **audio and images**. If you don't have one, see [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment with support for **audio and images**. If you don't have one, see [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
 
   * This article uses `Phi-4-multimodal-instruct`.
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-multi-modal/python.md b/articles/ai-foundry/model-inference/includes/use-chat-multi-modal/python.md
@@ -26,7 +26,7 @@ To use chat completion models in your application, you need:
 
 [!INCLUDE [how-to-prerequisites-python](../how-to-prerequisites-python.md)]
 
-* A chat completions model deployment with support for **audio and images**. If you don't have one, see [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
+* A chat completions model deployment with support for **audio and images**. If you don't have one, see [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a chat completions model to your resource.
 
   * This article uses `Phi-4-multimodal-instruct`.
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-reasoning/csharp.md b/articles/ai-foundry/model-inference/includes/use-chat-reasoning/csharp.md
@@ -21,7 +21,7 @@ To complete this tutorial, you need:
 
 [!INCLUDE [how-to-prerequisites-csharp](../how-to-prerequisites-csharp.md)]
 
-* A model with reasoning capabilities model deployment. If you don't have one read [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md) to add a reasoning model. 
+* A model with reasoning capabilities model deployment. If you don't have one read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a reasoning model. 
 
   * This example uses `DeepSeek-R1`.
 
diff --git a/articles/ai-foundry/model-inference/includes/use-chat-reasoning/javascript.md b/articles/ai-foundry/model-inference/includes/use-chat-reasoning/javascript.md
@@ -21,7 +21,7 @@ To complete this tutorial, you need:
 
 [!INCLUDE [how-to-prerequisites-javascript](../how-to-prerequisites-javascript.md)]
 
-* A model with reasoning capabilities model deployment. If you don't have one read [Add and configure models to Azure AI services](../../how-to/create-model-deployments.md) to add a reasoning model. 
+* A model with reasoning capabilities model deployment. If you don't have one read [Add and configure Foundry Models](../../how-to/create-model-deployments.md) to add a reasoning model. 
 
   * This example uses `DeepSeek-R1`.
       
diff --git a/articles/ai-foundry/model-inference/overview.md b/articles/ai-foundry/model-inference/overview.md
@@ -16,7 +16,7 @@ recommendations: false
 
 # What are Azure AI Foundry Models?
 
-Foundry Models provide access to the most powerful models available in the industry. The models come from key model providers in the AI space, including OpenAI, Microsoft, Meta, Mistral, Cohere, G42, and AI21 Labs. These models can be integrated with software solutions to deliver a wide range of tasks that include content generation, summarization, image understanding, semantic search, and code generation.
+Azure AI Foundry Models (formerly known Azure AI model inference) provide access to the most powerful models available in the industry. The models come from key model providers in the AI space, including OpenAI, Microsoft, Meta, Mistral, Cohere, G42, and AI21 Labs. These models can be integrated with software solutions to deliver a wide range of tasks that include content generation, summarization, image understanding, semantic search, and code generation.
 
 AI Foundry Models provides a way to **consume models as APIs without hosting them on your infrastructure**. Models are hosted in a Microsoft-managed infrastructure, which enables API-based access to the model provider's model. API-based access can dramatically reduce the cost of accessing a model and simplify the provisioning experience.
 
diff --git a/zone-pivots/zone-pivot-groups.yml b/zone-pivots/zone-pivot-groups.yml
@@ -635,6 +635,15 @@ groups:
       title: JavaScript
     - id: programming-language-rest
       title: REST
+- id: azure-ai-foundry-models-samples
+# Owner: santiagxf
+  title: API
+  prompt: Choose an API
+  pivots:
+    - id: api-openai
+      title: OpenAI
+    - id: api-inference
+      title: Model Inference
 - id: azure-ai-inference-samples
 # Owner: santiagxf
   title: Programing languages
