How to
How to

Use custom OpenAI compatible host

It's possible to use a custom OpenAI compatible host with Geeps either by modifying the main OpenAI configuration or by adding an OpenAI compatible provider (if you enabled multiple providers).

The API you want to use needs to be compatible with OpenAI SDK.

We will use xAI Grok API for this example.

Please note: For successful API key test you need to have a positive balance on your API account!

Option 1. Modify the main OpenAI configuration

To use xAI instead of OpenAI as the main provider:

  • open Settings > Configuration (macOS) or Settings > API Settings (iOS)
  • enter your xAI API key
  • toggle Use custom host switch to on
  • enter host api.x.ai in the host field without❗️ https:// or any slashes and paths like /v1 etc.
  • enter model manually in the textfield exactly as it's named in the xAI API documentation, e.g. grok-2-vision-1212
  • click/tap Submit to test your API key
Enter base host only and model name
Enter base host only and model name
Option 2. Add OpenAI compatible provider

If you enabled multiple providers, you can add xAI as an OpenAI compatible provider:

  • enter your xAI API key
  • enter host api.x.ai without protocol or any slashes or paths
  • enter model manually, e.g. grok-2-vision-1212
  • hit Submit to test the API key
Enter base host and model name
Enter base host and model name

Use Azure OpenAI endpoint

Azure OpenAI endpoints are not 100% compatible with OpenAI SDK, but many features are supported. To use Azure OpenAI endpoint:

  • create a deployment in Azure AI Foundry with your chosen model.
  • in the deployment details copy the full endpoint URL and enter it in the Azure endpoint field in the settings. The URL should look like this: https://<your-resource>.cognitiveservices.azure.com/openai/deployments/<your-deployed-model>/chat/completions?api-version=2025-01-01-preview
  • if you enter Azure endpoint, leave the custom host field empty. You can also leave the model field empty as it is included in the URL.
  • enter your Azure API key in the API key field
  • make sure you have set the correct quota in Azure and you have a positive balance on your account
Copy endpoint URL and API Key from Azure deployment
1/2Copy endpoint URL and API Key from Azure deployment
Enter full Azure endpoint URL
2/2Enter full Azure endpoint URL
Other providers

OpenAI compatible host should work with providers like xAI API (Grok), Deepseek API, TogetherAI, Perplexity and others as long as they are compatible with OpenAI SDK. Some features may not be available.