Headers

Obiguard API accepts 4 kinds of headers for your requests:


Obiguard Authentication Header	`Required`	For Obiguard auth
Provider Authentication Headers OR Cloud-Specific Headers	`Required`	For provider auth
Custom Headers	`Optional`	To forward any other headers directly

Obiguard Authentication

Obiguard API Key

string

required

Authenticate your requests with your Obiguard API key. Obtain API key from the Obiguard dashboard.
Environment variable: OBIGUARD_API_KEY

Example

Python SDK
cURL

Python

from obiguard import Obiguard

client = Obiguard(
  obiguard_api_key = "OBIGUARD_API_KEY" # defaults to os.environ.get("OBIGUARD_API_KEY")
)

cURL

curl https://gateway.obiguard.ai/v1/chat/completions \
  -H "x-obiguard-api-key: $OBIGUARD_API_KEY" \

Provider Authentication

In addition to the Obiguard API key, you must provide information about the AI provider you’re using. There are 4 ways to do this:

1. Provider Slug + Auth

Useful if you do not want to save your API keys to Obiguard vault and make direct requests.

string

Specifies the provider you’re using (e.g., openai, anthropic, vertex-ai).
List of Obiguard supported providers here.

string

Pass the auth details for the specified provider as a "Bearer $TOKEN".

If your provider expects their auth with headers such as x-api-key or api-key, you can pass the token with the Authorization header directly and Obiguard will convert it into the provider-specific format.

Example

curl https://gateway.obiguard.ai/v1/chat/completions \
  -H "x-obiguard-api-key: $OBIGUARD_API_KEY" \
  -H "x-obiguard-provider: openai" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \

from obiguard import Obiguard

client = Obiguard(
  api_key = "OBIGUARD_API_KEY", # defaults to os.environ.get("OBIGUARD_API_KEY")
  provider = "openai",
  Authorization = "Bearer OPENAI_API_KEY"
)

2. Virtual Key

string

Save your provider auth on Obiguard and use a virtual key to directly make a call. This value is pass in the same field as Obiguard API key. Docs

Example

Python SDK
cURL

Python

from obiguard import Obiguard

client = Obiguard(
  obiguard_api_key="vk-obg***",  # Your Obiguard virtual key
)

cURL

curl https://gateway.obiguard.ai/v1/chat/completions \
  -H "x-obiguard-api-key: $OBIGUARD_API_KEY" \

4. Custom Host

string

Specifies the base URL where you want to send your request

string

Target provider that’s availabe on your base URL. If you are unsure of which target provider to set, you can set openai.

string

Example

Python SDK
cURL

Python

from obiguard import Obiguard

client = Obiguard(
  obiguard_api_key="sk-obg***",  # Your Obiguard API key
  custom_host = "http://124.124.124.124/v1",
  provider = "openai",
  Authorization = "Bearer TOKEN"
)

cURL

curl https://gateway.obiguard.ai/v1/chat/completions \
  -H "x-obiguard-api-key: $OBIGUARD_API_KEY" \
  -H "x-obiguard-custom-host: http://124.124.124.124/v1" \
  -H "x-obiguard-provider: openai" \
  -H "Authorization: Bearer $TOKEN" \

Custom Headers

You can pass any other headers your API expects by directly forwarding them without any processing by Obiguard.
This is especially useful if you want to pass send sensitive headers.

Forward Headers

array of strings

Pass all the headers you want to forward directly in this array. (Docs)

Example

curl https://gateway.obiguard.ai/v1/chat/completions \
  -H "x-obiguard-api-key: $OBIGUARD_API_KEY" \
  -H "X-Custom-Header: ...."\
  -H "Another-Header: ....."\
  -H "x-obiguard-forward-headers: ['X-Custom-Header', 'Another-Header']" \

from obiguard import Obiguard

client = Obiguard(
  obiguard_api_key = "OBIGUARD_API_KEY", # defaults to os.environ.get("OBIGUARD_API_KEY")
  X_Custom_Header = "....",
  Another_Header = "....",
  forward_headers = ['X_Custom_Header', 'Another_Header']
)

Python Usage

With the Python SDK, you need to transform your headers to Snake Case and then include them while initializing the Obiguard client. Example: If you have a header of the format X-My-Custom-Header, it should be sent as X_My_Custom_Header in the SDK

JavaScript Usage

With the JS SDK, you need to transform your headers to Camel Case and then include them while initializing the Obiguard client. Example: If you have a header of the format X-My-Custom-Header, it should be sent as xMyCustomHeader in the SDK

Cloud-Specific Headers (`Azure`, `Google`, `AWS`)

Pass more configuration headers for Azure OpenAI, Google Vertex AI, or AWS Bedrock

Azure

x-obiguard-azure-resource-name, x-obiguard-azure-deployment-id, x-obiguard-azure-api-version, Authorization, x-obiguard-azure-model-name

Google Vertex AI

x-obiguard-vertex-project-id, x-obiguard-vertex-region, X-Vertex-AI-LLM-Request-Type

AWS Bedrock

x-obiguard-aws-session-token, x-obiguard-aws-secret-access-key, x-obiguard-aws-region, x-obiguard-aws-session-token

List of All Headers

The following is a comprehensive list of headers that can be used when initializing the Obiguard client. Obiguard adheres to language-specific naming conventions:

camelCase for JavaScript/Node.js parameters
snake_case for Python parameters
hyphenated-keys for HTTP headers

Python
REST Headers

Parameter	Type	Key
API Key Your Obiguard account’s API Key.	stringrequired	`obiguard_api_key`
Provider The AI provider to use for your calls. (supported providers).	string	`provider`
Base URL You can edit the URL of the gateway to use.	string	`base_url`
Custom Host Route to locally or privately hosted model by configuring the API URL with custom host	string	`custom_host`
Forward Headers Forward sensitive headers directly to your model’s API without any processing from Obiguard.	array of string	`forward_headers`
Azure OpenAI Headers Configuration headers for Azure OpenAI that you can send separately	string	`azure_resource_name` `azure_deployment_id` `azure_api_version` `azure_model_name`
Google Vertex AI Headers Configuration headers for Vertex AI that you can send separately	string	`vertex_project_id` `vertex_region`
AWS Bedrock Headers Configuration headers for Bedrock that you can send separately	string	`aws_access_key_id` `aws_secret_access_key` `aws_region` `aws_session_token`

Parameter	Type	Header Key
API Key Your Obiguard account’s API Key.	stringrequired	`x-obiguard-api-key`
Provider The AI provider to use for your calls. (supported providers).	string	`x-obiguard-provider`
Base URL You can edit the URL of the gateway to use.	string	Change the request URL
Forward Headers Forward sensitive headers directly to your model’s API without any processing from Obiguard.	array of string	`x-obiguard-forward-headers`
Azure OpenAI Headers Configuration headers for Azure OpenAI that you can send separately	string	`x-obiguard-azure-resource-name`, `x-obiguard-azure-deployment-id`, `x-obiguard-azure-api-version`, `x-obiguard-azure-model-name`
Google Vertex AI Headers Configuration headers for Vertex AI that you can send separately	string	`x-obiguard-vertex-project-id`, `x-obiguard-vertex-region`
AWS Bedrock Headers Configuration headers for Bedrock that you can send separately	string	`x-obiguard-aws-session-token`, `x-obiguard-aws-secret-access-key`, `x-obiguard-aws-region`, `x-obiguard-aws-session-token`

Using Headers

You can send these headers in multiple ways:

Python SDK
OpenAI SDK
cURL

Obiguard SDK

# Python - At initialization
from obiguard import Obiguard

client = Obiguard(
  obiguard_api_key="vk-obg***",  # Your Obiguard virtual key
)

# Python - At runtime
completion = client.with_options(
  trace_id="your_trace_id",
  metadata={"_user": "user_12345"}
).chat.completions.create(
  messages=[{"role": "user", "content": "Hello!"}],
  model="gpt-4o"
)

OpenAI SDK

# Python
from openai import OpenAI
from obiguard import OBIGUARD_GATEWAY_URL, createHeaders

# At initialization
client = OpenAI(
  api_key="OPENAI_API_KEY",
  base_url=OBIGUARD_GATEWAY_URL,
  default_headers=createHeaders({
    obiguard_api_key="vk-obg***",  # Your Obiguard virtual key
  })
)

# At runtime
response = client.chat.completions.create(
  model="gpt-4o",
  messages=[{"role": "user", "content": "Hello!"}]
)

REST API

curl https://gateway.obiguard.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "x-obiguard-api-key: $OBIGUARD_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

API Documentation

SDK

Chat Completions

Embeddings

Images

Audio

Completions

Other APIs

Obiguard Authentication

Obiguard API Key

Provider Authentication

1. Provider Slug + Auth

2. Virtual Key

4. Custom Host

Custom Headers

Forward Headers

Python Usage

JavaScript Usage

Cloud-Specific Headers (`Azure`, `Google`, `AWS`)

Azure

Google Vertex AI

AWS Bedrock

List of All Headers

Using Headers

​Obiguard Authentication

​Obiguard API Key

​Provider Authentication

​1. Provider Slug + Auth

​2. Virtual Key

​4. Custom Host

​Custom Headers

​Forward Headers

​Python Usage

​JavaScript Usage

​Cloud-Specific Headers (Azure, Google, AWS)

​Azure

​Google Vertex AI

​AWS Bedrock

​List of All Headers

​Using Headers

Obiguard Authentication

Obiguard API Key

Provider Authentication

1. Provider Slug + Auth

2. Virtual Key

4. Custom Host

Custom Headers

Forward Headers

Python Usage

JavaScript Usage

Cloud-Specific Headers (`Azure`, `Google`, `AWS`)

Azure

Google Vertex AI

AWS Bedrock

List of All Headers

Using Headers