Custom Providers

UniterRouter supports integrating custom OpenAI-compatible providers, allowing you to use any API that follows the OpenAI chat completions format. This feature is perfect for:

• Specialized AI providers not natively supported
• Internal AI services within your organization
• Testing against different model endpoints
• Private LLM deployments in your infrastructure

Quick Setup

1. Add a Custom Provider Key

Navigate to your organization's provider settings and add a custom provider via the UI. Provide a lowercase name, OpenAI-compatible base URL, and API token for the custom provider.

2. Make Requests

Once configured, make requests using the format {customName}/{modelName}:

curl -X POST "https://api.uniterouter.ai/v1/chat/completions" \
  -H "Authorization: Bearer $UNITEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mycompany/custom-gpt-4",
    "messages": [
      {
        "role": "user",
        "content": "Hello from my custom provider!"
      }
    ]
  }'

Configuration Requirements

Custom Provider Name

• Format: Lowercase letters only (a-z)
• Examples: mycompany, internal, testing
• Invalid: MyCompany, my-company, my_company, 123test

Base URL

• Must be a valid HTTPS URL
• Should point to your provider's base endpoint
• UniterRouter will append /v1/chat/completions automatically
• Example: https://api.example.com → https://api.example.com/v1/chat/completions

API Token

• Provider-specific authentication token
• Used in the Authorization: Bearer {token} header

Supported Features

Custom providers inherit full UniterRouter functionality.