feat: init

Author: santiagxf

articles/ai-foundry/model-inference/concepts/models.md

@@ -0,0 +1,35 @@
+---
+title: Configure access to Azure Ecosystem Models
+description: Learn how to configure access to Azure Ecosystem Models.
+author: santiagxf
+ms.author: fasantia 
+ms.service: azure-ai-model-inference
+ms.topic: how-to
+ms.date: 5/11/2025
+---
+
+# Configure access to Azure Ecosystem Models
+
+Certain models in AI Foundry Models are offered directly by the model provider through the Azure Marketplace. This article explains the requirements to use Azure Marketplace if you plan to use such models in your workloads. Azure Direct Models, like DeepSeek or Phi, or Azure OpenAI Service models, like GPTs, don't have this requirement. 
+
+> [!TIP]
+> All models offered in AI Foundry Models are hosted in Microsoft's Azure environment and the Service does NOT interact with any external services or model provider.
+
+:::image type="content" source="../media/configure-marketplace/azure-marketplace-3p.png" alt-text="An diagram with the overall architecture of Azure Marketplace integration with AI Foundry Models." lightbox="../media/configure-marketplace/azure-marketplace-3p.png":::
+
+[!INCLUDE [marketplace-rbac](../includes/configure-marketplace/rbac.md)]
+
+## Country availability
+
+Pay-as-you-go billing is available only to users whose Azure subscription belongs to a billing account in a country/region where the model offer is available. Availability varies per model provider and model SKU. Read [Region availability for models](../../how-to/deploy-models-serverless-availability.md).
+
+## Troubleshooting
+
+Use the following troubleshooting guide to find and solve errors when deploying third-party models in AI Foundry Models:
+
+| Error | Description |
+|-------|-------------|
+| This offer is not made available by the provider in the country where your account and Azure Subscription are registered. | The model provider didn't make the specific model SKU available in the country where the subscription is registered. Each model provider may decide to make the offer available in specific countries and such may vary by model SKU. You need to deploy the model to a subscription having billing on a supported country. See the list of countries at [Region availability for models](../../how-to/deploy-models-serverless-availability.md).  |
+| Marketplace Subscription purchase eligibility check failed. | The model provider didn't make the specific model SKU available in the country where the subscription is registered or it isn't available in the region where you deployed the Azure AI Services resource. See [Region availability for models](../../how-to/deploy-models-serverless-availability.md). |
+| Unable to create a model deployment for model "model-name". If the error persists, please contact HIT (Human Intelligence Team) via this link: https://go.microsoft.com/fwlink/?linkid=2101400&clcid=0x409 and request to allowlist the Azure subscription. | Azure Marketplace rejects the request to create a model subscription. Such can be due to multiple reasons, including subscribing to the model offering too often, or from multiple subscriptions at the same time. Please contact support using the provided link indicating your subscription ID. |
+| This offer is not available for purchasing by subscriptions belonging to Microsoft Azure Cloud Solution Providers | Cloud Solution Provider (CSP) subscriptions do not have the ability to purchase third-party model offerings. You can consider models offered as first-party consumption service. |

articles/ai-foundry/model-inference/how-to/configure-marketplace.md

@@ -0,0 +1,25 @@
+---
+manager: nitinme
+author: santiagxf
+ms.author: fasantia 
+ms.service: azure-ai-model-inference
+ms.date: 5/11/2025
+ms.topic: include
+---
+
+## Permissions required to subscribe to Azure Ecosystem Models
+
+Azure Ecosystem Models available for deployment (for example, Cohere models) require Azure Marketplace. Model providers define the license terms and set the price for use of their models using Azure Marketplace.
+
+When deploying third-party models, ensure you have the following permissions in your account:
+
+> [!div class="checklist"]
+> * On the Azure subscription:
+>   * `Microsoft.MarketplaceOrdering/agreements/offers/plans/read`
+>   * `Microsoft.MarketplaceOrdering/agreements/offers/plans/sign/action`
+>   * `Microsoft.MarketplaceOrdering/offerTypes/publishers/offers/plans/agreements/read`
+>   * `Microsoft.Marketplace/offerTypes/publishers/offers/plans/agreements/read`
+>   * `Microsoft.SaaS/register/action`
+> * On the resource group—to create and use the SaaS resource:
+>   * `Microsoft.SaaS/resources/read`
+>   * `Microsoft.SaaS/resources/write`

articles/ai-foundry/model-inference/includes/configure-marketplace/rbac.md

@@ -41,6 +41,8 @@ The files for this example are in:
 cd azureai-model-inference-bicep/infra
 ```
 
+[!INCLUDE [marketplace-rbac](../includes/configure-marketplace/rbac.md)]
+
 ## Add the model
 
 1. Use the template `ai-services-deployment-template.bicep` to describe model deployments:

articles/ai-foundry/model-inference/includes/create-model-deployments/bicep.md

@@ -17,4 +17,6 @@ To complete this article, you need:
 
 * An Azure subscription. If you're using [GitHub Models](https://docs.github.com/en/github-models/), you can upgrade your experience and create an Azure subscription in the process. Read [Upgrade from GitHub Models to Azure AI Foundry Models](../../how-to/quickstart-github-models.md) if that's your case.
 
-* An Azure AI Foundry resource (formerly known as Azure AI Services). For more information, see [Create and configure all the resources for Azure AI Foundry Models](../../how-to/quickstart-create-resources.md).
+* An Azure AI Foundry resource (formerly known as Azure AI Services). For more information, see [Create and configure all the resources for Azure AI Foundry Models](../../how-to/quickstart-create-resources.md).
+
+* [Azure Ecosystem Models](../../concepts/models.md#azure-ecosystem-models) require access to **Azure Marketplace**. Ensure you have the [permissions required to subscribe to model offerings](../../how-to/configure-marketplace.md). [Azure Direct Models](../../concepts/models.md#azure-direct-models) don't have this requirement.

articles/ai-foundry/model-inference/includes/create-model-deployments/intro.md

@@ -30,6 +30,8 @@ The files for this example are in:
 cd azureai-model-inference-bicep/infra
 ```
 
+[!INCLUDE [marketplace-rbac](../includes/configure-marketplace/rbac.md)]
+
 ## Create the resources
 
 Follow these steps:

articles/ai-foundry/model-inference/includes/create-resources/bicep.md

@@ -8,7 +8,7 @@ reviewer: santiagxf
 ms.service: azure-ai-model-inference
 ms.topic: concept-article
 ms.date: 01/24/2025
-ms.author: mopeakande
+ms.author: mopeak
 ms.reviewer: fasantia
 ms.custom: generated
 recommendations: false
@@ -24,9 +24,7 @@ AI Foundry Models is part of Azure AI Foundry, and users can access the service
 
 ## Models
 
-You can get access to the key model providers in the industry including OpenAI, Microsoft, Meta, Mistral, Cohere, G42, and AI21 Labs. Model providers define the license terms and set the price for use of their models.
-
-Explore the following model families available:
+You can get access to the key model providers in the industry. Explore the following model families available:
 
 - [AI21 Labs](concepts/models.md#ai21-labs)
 - [Azure OpenAI](concepts/models.md#azure-openai)

articles/ai-foundry/model-inference/media/configure-marketplace/azure-marketplace-3p.png

@@ -52,6 +52,8 @@ items:
     href: ./how-to/quickstart-create-resources.md
   - name: Add and configure models
     href: ./how-to/create-model-deployments.md
+  - name: Configure Azure Ecosystem Models
+    href: ./how-to/configure-marketplace.md
   - name: Connect your AI project
     href: ./how-to/configure-project-connection.md
   - name: Responsible AI