Skip to main content

Upgrade from GitHub Models to Microsoft Foundry Models

This article refers to the Microsoft Foundry (new) portal.
In this article, you learn to develop a generative AI application by starting from GitHub Models and then upgrade your experience by deploying a Foundry Tools resource with Microsoft Foundry Models. GitHub Models are useful when you want to find and experiment with AI models for free as you develop a generative AI application. When you’re ready to bring your application to production, upgrade your experience by deploying a Foundry Tools resource in an Azure subscription and start using Foundry Models. You don’t need to change anything else in your code. The playground and free API usage for GitHub Models are rate limited by requests per minute, requests per day, tokens per request, and concurrent requests. If you get rate limited, you need to wait for the rate limit that you hit to reset before you can make more requests.

Prerequisites

You need:

Upgrade to Foundry Models

The rate limits for the playground and free API usage help you experiment with models and develop your AI application. When you’re ready to bring your application to production, use a key and endpoint from a paid Azure account. You don’t need to change anything else in your code.
GitHub Models are free with rate limits. After you upgrade to Foundry Models, usage is billed to your Azure subscription based on the deployment type you choose.
To get the key and endpoint:
  1. Go to GitHub Models and select a model to land on its playground. This article uses Mistral Medium 3 (25.05).
  2. Type in some prompts or use some of the suggested prompts to interact with the model in the playground.
  3. Select Use this model from the playground. This action opens up a window to “Get started with Models in your codebase”.
  4. In the “Configure authentication” step, select Get Microsoft Foundry key from the “Azure AI” section.
A screenshot showing how to get the Azure AI production key from the playground of a GitHub Model.
  1. If you’re already signed in to your Azure account, skip this step. However, if you don’t have an Azure account or you’re not signed in to your account, follow these steps:
    1. If you don’t have an Azure account, select Create my account and follow the steps to create one.
    2. Alternatively, if you have an Azure account, select Sign back in. If your existing account is a free account, you first have to upgrade to a standard plan.
    3. Return to the model’s playground and select Get Microsoft Foundry key again.
    4. Sign in to your Azure account.
  2. You’re taken to Foundry > GitHub and land on the home page in a Foundry project.
If you land in the Foundry (classic) experience, toggle the New Foundry switcher in the upper-right navigation to switch to the new Foundry experience.
  1. Follow the steps in Deploy a model to deploy the model of your choice, test it in the Playground, and inference the deployed model with code.
  2. Verify the deployment works by sending a test prompt in the Playground. If you receive a response, your model is ready to use from code.
Unlike GitHub Models where all the models are already configured, the Foundry Tools resource allows you to control which models are available in your endpoint and under which configuration. Add as many models as you plan to use before indicating them in the model parameter. Learn how to add more models to your resource.

Explore additional features

Foundry Models supports features that aren’t available in GitHub Models:
  • Model catalog — Browse, compare, and evaluate models from Azure, partners, and the open-source community.
  • Keyless authentication — Use Microsoft Entra ID for token-based authentication without managing API keys.
  • Content filtering — Configure content safety filters for your deployments.
  • Rate limiting — Set custom rate limits for specific models in your resource.
  • Deployment types — Choose from multiple deployment SKUs such as pay-per-token, provisioned, and batch.

Troubleshoot common issues

IssueResolution
Model not available in your regionCheck the model’s region availability on its model catalog page and choose a supported region.
Authentication error after key swapVerify you copied the correct key from the Foundry portal. Select Project settings > Keys and endpoints to view your keys.
Rate limit errors after upgradeFoundry Models rate limits depend on your deployment type. Scale up or choose a higher-throughput deployment.