> ## Documentation Index
> Fetch the complete documentation index at: https://hobbyist-e43fa225.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy Microsoft Foundry Models in the Foundry portal

> Learn how to deploy Microsoft Foundry Models in the Foundry portal for AI inference applications and integration into your projects.

In this article, you learn how to use the Foundry portal to deploy a Foundry Model in a Foundry resource for inference. Foundry Models include models such as Azure OpenAI models, Meta Llama models, and more. After you deploy a Foundry Model, you can interact with it in the Foundry Playground and use it from code.

This article uses a Foundry Model from partners and community `Llama-3.2-90B-Vision-Instruct` for illustration. Models from partners and community require that you subscribe to Azure Marketplace before deployment. On the other hand, Foundry Models sold by Azure, such as Azure OpenAI in Foundry Models, don't have this requirement. For more information about Foundry Models, including the regions where they're available for deployment, see [Foundry Models sold by Azure](/models/models-sold-directly-by-azure) and [Foundry Models from partners and community](/models/models-from-partners).

## Prerequisites

To complete this article, you need:

* An Azure subscription with a valid payment method. If you don't have an Azure subscription, create a [paid Azure account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn) to begin. If you're using GitHub Models, you can [upgrade to Foundry Models](/models/quickstart-github-models) and create an Azure subscription in the process.

* The **Cognitive Services Contributor** role or equivalent permissions on the Foundry resource to create and manage deployments. For more information, see [Azure RBAC roles](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles).

* A [Microsoft Foundry project](../../how-to/create-projects). This kind of project is managed under a Foundry resource.

* [Foundry Models from partners and community](/models/models-from-partners) require access to **Azure Marketplace** to create subscriptions. Ensure you have the [permissions required to subscribe to model offerings](../how-to/configure-marketplace). [Foundry Models sold by Azure](/models/models-sold-directly-by-azure) don't have this requirement.

## Deploy a model

Deploy a model by following these steps in the Foundry portal:

1. Sign in to [Microsoft Foundry](https://ai.azure.com/?cid=learnDocs). Make sure the **New Foundry** toggle is on. These steps refer to **Foundry (new)**.

<img src="https://mintcdn.com/hobbyist-e43fa225/_qpHdwibkfCcXaky/images/new-foundry.png?fit=max&auto=format&n=_qpHdwibkfCcXaky&q=85&s=1338a0cf43c92807e8bcccdd0223d052" width="184" height="36" data-path="images/new-foundry.png" />

1. From the Foundry portal homepage, select **Discover** in the upper-right navigation, then **Models** in the left pane.

2. Select a model and review its details in the model card. This article uses `Llama-3.2-90B-Vision-Instruct` for illustration.

3. Select **Deploy** > **Custom settings** to customize your deployment. Alternatively, you can use the default deployment settings by selecting **Deploy** > **Default settings**.

4. For [Foundry Models from partners and community](/models/models-from-partners), you need to subscribe to Azure Marketplace. This requirement applies to `Llama-3.2-90B-Vision-Instruct`, for example. Read the terms of use and select **Agree and Proceed** to accept the terms.

<Note>
  For [Foundry Models sold by Azure](/models/models-sold-directly-by-azure), such as the Azure OpenAI model `gpt-4o-mini`, you don't subscribe to Azure Marketplace.
</Note>

1. Configure the deployment settings:

   * By default, the deployment uses the model name. You can modify this name before deploying.
   * During inference, the deployment name is used in the `model` parameter to route requests to this particular deployment.

   Select **Deploy** to create your deployment.

<Tip>
  Each model supports different deployment types, providing different data residency or throughput guarantees. See [deployment types](/models/deployment-types) for more details. In this example, the model supports the Global Standard deployment type.
</Tip>

1. When the deployment completes, you land on the [Foundry Playgrounds](/developer-tools-and-integrations/concept-playgrounds) where you can interactively test the model. Your project and resource must be in one of the supported regions of deployment for the model. Verify that the deployment status shows **Succeeded** in your deployment list.

## Manage models

You can manage the existing model deployments in the resource by using the Foundry portal.

1. Select **Build** in the upper-right navigation.

2. Select **Models** in the left pane to see the list of deployments in the resource.

From a deployment's detail page, you can view endpoint details and keys, adjust deployment settings, or delete a deployment that you no longer need.

## Test the deployment in the playground

You can interact with the new model in the Foundry portal by using the playground. The playground is a web-based interface that lets you interact with the model in real-time. Use the playground to test the model with different prompts and see the model's responses.

1. From the list of deployments, select the **Llama-3.2-90B-Vision-Instruct** deployment to open up the playground page.

2. Type your prompt and see the outputs.

3. Select the **Code** tab to see details about how to access the model deployment programmatically.

## Use the model with code

To run inference on the deployed model, see the following examples:

* To use the **Responses API with Foundry Models sold by Azure**, such as Microsoft AI, DeepSeek, and Grok models, see [How to generate text responses with Microsoft Foundry Models](/models/generate-responses).

* To use the **Responses API with OpenAI models**, see [Getting started with the responses API](/models/responses).

* To use the **Chat completions API with models sold by partners**, such as the Llama model deployed in this article, see [Model support for chat completions](../../openai/api-version-lifecycle#model-support).

## Regional availability and quota limits of a model

For Foundry Models, the default quota varies by model and region. Certain models might only be available in some regions. For more information on availability and quota limits, see [Azure OpenAI in Microsoft Foundry Models quotas and limits](/models/quotas-limits) and [Microsoft Foundry Models quotas and limits](/models/quotas-limits).

## Quota for deploying and running inference on a model

For Foundry Models, deploying and running inference consume quota that Azure assigns to your subscription on a per-region, per-model basis in units of Tokens-per-Minute (TPM). When you sign up for Foundry, you receive default quota for most of the available models. Then, you assign TPM to each deployment as you create it, which reduces the available quota for that model. You can continue to create deployments and assign them TPMs until you reach your quota limit.

When you reach your quota limit, you can only create new deployments of that model if you:

* Request more quota by submitting a [quota increase form](https://aka.ms/oai/stuquotarequest).
* Adjust the allocated quota on other model deployments in the Foundry portal, to free up tokens for new deployments.

For more information about quota, see [Microsoft Foundry Models quotas and limits](/models/quotas-limits) and [Manage Azure OpenAI quota](https://learn.microsoft.com/en-us/azure/foundry-classic/openai/how-to/quota).

## Troubleshooting

| Issue                              | Resolution                                                                                                               |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Quota exceeded                     | [Request more quota](https://aka.ms/oai/stuquotarequest) or reallocate TPM from existing deployments.                    |
| Region not supported               | Check [regional availability](/models/quotas-limits) and deploy in a supported region.                                   |
| Marketplace subscription error     | Verify you have the [required permissions](../how-to/configure-marketplace) to subscribe to Azure Marketplace offerings. |
| Deployment status shows **Failed** | Confirm that the model is available in your selected region and that you have sufficient quota.                          |

## Related content

* [Elevated-role tasks in Microsoft Foundry](../../concepts/administrator-guide#deploy-and-manage-models) — role requirements for model deployment.
* [How to generate text responses with Microsoft Foundry Models](/models/generate-responses)
* [Deployment types for Foundry Models](/models/deployment-types)
* [Instant access to models in Microsoft Foundry (preview)](/models/instant-models)
* [Deploy models using Azure CLI and Bicep](/models/create-model-deployments)
* [Azure OpenAI supported programming languages](/models/supported-languages)
