x-inference-provider-url.
Browse Integrations
How Catalyst Integrations Work
Every documented integration ultimately routes requests through the Catalyst gateway. You keep your existing provider API keys. Your Catalyst project API key authenticates requests to the gateway, and a small set of headers control routing, environments, and task grouping.Required Routing Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <your-project-api-key> authenticates the request to the gateway and links it to your project. For OpenAI-compatible SDKs, set this as the SDK’s apiKey. |
x-inference-provider-api-key | Yes | Your provider API key, such as OpenAI or Groq. The gateway forwards it downstream. For Anthropic’s native SDK, use x-api-key instead. |
x-inference-provider | Yes | Routes the request to the correct provider, such as openai, anthropic, or cerebras. |
x-inference-environment | No | Tags requests with an environment, such as production or staging. |
x-inference-task-id | No | Groups requests under a logical task for filtering and analytics. |
x-inference-provider-url | No | Routes to any OpenAI-compatible provider by specifying its base URL. |
Supported OpenAI-compatible Provider URLs
Any OpenAI-compatible provider can be used via thex-inference-provider-url header, even when it does not have a dedicated guide in the catalog yet.
| Provider | Base URL |
|---|---|
| OpenAI | https://api.openai.com/v1 |
| OpenRouter | https://openrouter.ai/api |
| Anthropic | https://api.anthropic.com/v1 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta/openai |
| Azure OpenAI | https://{resource}.openai.azure.com/openai/deployments/{deployment} |
| Groq | https://api.groq.com/openai/v1 |
| Together AI | https://api.together.xyz/v1 |
| Fireworks AI | https://api.fireworks.ai/inference/v1 |
| Perplexity | https://api.perplexity.ai |
| Mistral | https://api.mistral.ai/v1 |
| DeepSeek | https://api.deepseek.com/v1 |
| Cerebras | https://api.cerebras.ai/v1 |
| Inference.net | https://api.inference.net/v1 |