Get Azure OpenAI credentials

Get your Azure OpenAI API key, base URL, and API version from the Azure Portal to start using Azure OpenAI models through Keywords AI.

​
Azure OpenAI models compatibility

​
Add Azure OpenAI API keys

There are 2 ways to add your Azure OpenAI credentials to your requests:

​
Via UI

1

Go to the Providers page

Go to Providers page
Providers Page
2

Add your Azure OpenAI credentials.

Dashboard Page
3

(Optional) Choose models you want to use credits

You can choose the models you want to use your credits with. Just simply type the model ID from the Models page and copy the model id and paste it in the input field. Press Enter to add the model.Leave it empty to apply your credentials for all Azure OpenAI models.Dashboard Page

​
Map your deployment name

We understand that you may have a custom name for your Azure deployment. So if you want to specify a particular model to test in the UI, you should map it as azure/{your deployment name}. For example, in Azure OpenAI, you might deployed gpt-4o as the deployment name gpt-4o or gpt-4o-whatever, so you should map it as azure/apgt-4o or azure/gpt-4o-whatever. Azure deployment name

​
Via Code

1

Map your deployment name

We understand that you may have a custom name for your Azure deployment. Keywords AI is using the model’s origin name which may not be able to match your deployment. You can use model_name_map to map the default name to your custom name.Here’s an example: if you want to use azure/gpt-4o on Keywords AI platform with your own Azure credentials and custom deployment name, you should put your custom deployment name in the model_name_map object, and we’ll use it to make requests to your deployment.
{
    "model": "azure/gpt-4o",
    "model_name_map": {
      "original_model_name": "azure/your_custom_model_name"
      // e.g, "azure/gpt-4o": "azure/{your gpt-4o's deployment name}"
    }
}
2

Add your own credentials

Add customer_credentials parameter in your request body to use your own Azure OpenAI credits.
model_name_map only works when your credentials is Valid.
{
  // Rest of the request body
  "customer_credentials": {
    "azure_openai": {
      "api_key": "YOUR_AZURE_OPENAI_API_KEY",
      "api_base": "YOUR_AZURE_OPENAI_API_BASE_URL",
      "api_version": "YOUR_AZURE_OPENAI_API_VERSION",
    }
  }
}
3

Override credentials for a particular model. (Optional)

One-off credential overrides. Instead of using what is uploaded for each provider, this targets credentials for individual models.
{
  // Rest of the request body
  "customer_credentials": {
    "azure_openai": {
      "api_key": "YOUR_AZURE_OPENAI_API_KEY",
      "api_base": "YOUR_AZURE_OPENAI_API_BASE_URL",
      "api_version": "YOUR_AZURE_OPENAI_API_VERSION",
    }
  },
  "credential_override": {
    "azure/gpt-4o":{ // override for a specific model.
      "api_key": "YOUR_ANOTHER_AZURE_OPENAI_API_KEY",
      "api_base": "YOUR_AZURE_OPENAI_API_BASE_URL",
      "api_version": "YOUR_AZURE_OPENAI_API_VERSION",
    }
  }
}
4

Add more deployments and load balance between them (Optional)

You can add more deployments and load balance between them. Learn more about how to do it here.

​
Requirements

  1. Ensure your deployment name matches those listed on our Models page.
  2. Confirm that your models are available in the region specified by your credentials.
    Credentials validation is not supported. Failure to comply with these requirements will result in errors!

​
Full request example

​
How to get your Azure OpenAI credentials

To find the parameters needed, you can follow these steps:
  • Visit your Azure Portal.
  • You will see your deployments via the above link, choose the deployment you want to use.
  • Click on the “Endpoints” link to get the API base URL.
  • Click on the “Manage Keys” link to get the API key.

​
Supported models

  • azure/gpt-35-turbo
  • azure/gpt-4
  • azure/gpt-4-1106-preview
  • azure/gpt-4-32k
  • azure/gpt-4o
  • azure/gpt-4o-mini
  • azure/gpt-4o-2024-08-06
  • azure/gpt-4-vision-preview
  • azure/o3-mini
You can find more models here.