Skip to main content
POST
/
api
/
providers
Error
A valid request URL is required to generate request examples
{
  "network_config": {
    "base_url": "<string>",
    "extra_headers": {},
    "default_request_timeout_in_seconds": 123,
    "max_retries": 123,
    "retry_backoff_initial": 123,
    "retry_backoff_max": 123,
    "insecure_skip_verify": true,
    "ca_cert_pem": "<string>",
    "allow_private_network": false
  },
  "concurrency_and_buffer_size": {
    "concurrency": 123,
    "buffer_size": 123
  },
  "proxy_config": {
    "url": "<string>",
    "username": "<string>",
    "password": "<string>",
    "ca_cert_pem": "<string>"
  },
  "send_back_raw_request": true,
  "send_back_raw_response": true,
  "store_raw_request_response": true,
  "custom_provider_config": {
    "is_key_less": true,
    "allowed_requests": {
      "list_models": true,
      "text_completion": true,
      "text_completion_stream": true,
      "chat_completion": true,
      "chat_completion_stream": true,
      "responses": true,
      "responses_stream": true,
      "count_tokens": true,
      "embedding": true,
      "speech": true,
      "speech_stream": true,
      "transcription": true,
      "transcription_stream": true,
      "image_generation": true,
      "image_generation_stream": true,
      "batch_create": true,
      "batch_list": true,
      "batch_retrieve": true,
      "batch_cancel": true,
      "batch_results": true,
      "file_upload": true,
      "file_list": true,
      "file_retrieve": true,
      "file_delete": true,
      "file_content": true
    },
    "request_path_overrides": {}
  },
  "status": "<string>",
  "description": "<string>",
  "config_hash": "<string>"
}

Authorizations

​
Authorization
string
header
required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Body

application/json

Add provider request. Keys are managed separately via /api/providers/{provider}/keys.

​
provider
enum<string>
required

AI model provider identifier

Available options:
openai,
azure,
anthropic,
bedrock,
cohere,
vertex,
vllm,
mistral,
ollama,
groq,
sgl,
parasail,
perplexity,
replicate,
cerebras,
gemini,
openrouter,
elevenlabs,
huggingface,
nebius,
xai,
runway,
fireworks
​
network_config
object

Network configuration for provider connections

​
concurrency_and_buffer_size
object

Concurrency settings

​
proxy_config
object

Proxy configuration

​
send_back_raw_request
boolean
​
send_back_raw_response
boolean
​
store_raw_request_response
boolean
​
custom_provider_config
object

Custom provider configuration

Response

Provider added successfully

Provider configuration response

​
name
enum<string>

AI model provider identifier

Available options:
openai,
azure,
anthropic,
bedrock,
cohere,
vertex,
vllm,
mistral,
ollama,
groq,
sgl,
parasail,
perplexity,
replicate,
cerebras,
gemini,
openrouter,
elevenlabs,
huggingface,
nebius,
xai,
runway,
fireworks
​
network_config
object

Network configuration for provider connections

​
concurrency_and_buffer_size
object

Concurrency settings

​
proxy_config
object

Proxy configuration

​
send_back_raw_request
boolean
​
send_back_raw_response
boolean
​
store_raw_request_response
boolean
​
custom_provider_config
object

Custom provider configuration

​
provider_status
enum<string>

Status of the provider

Available options:
active,
error,
deleted
​
status
string

Operational status (e.g., list_models_failed)

​
description
string

Error/status description

​
config_hash
string

Hash of config.json version, used for change detection