Authentication

Every request to the Infyrence Gateway is authenticated with an API key. You send the key as an HTTP Bearer token in the Authorization header. The gateway is OpenAI-compatible, so the OpenAI SDKs send this header for you once you set your key.

Get your API key

Create and manage keys in the dashboard. Your key looks like sk- followed by a long string.

Open the dashboard

Go to API keys in your Infyrence dashboard.

Create a key

Create a new key and give it a name so you can identify it later.

Copy the key

Copy the full sk-... value and store it somewhere safe.

The full key value is shown only once, at creation. Infyrence stores only a hash of your key and cannot show it to you again. If you lose it, create a new key and update your app.

Send the key

Set the Authorization header to Bearer followed by your key.

Authorization: Bearer sk-...

Point an OpenAI SDK at the Infyrence base URL and pass your key as the api_key (Python) or apiKey (JavaScript). No other code change is needed.

curl https://api.infyrence.com/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.infyrence.com/v1",
    api_key="sk-...",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.infyrence.com/v1",
  apiKey: "sk-...",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

Every model and inference endpoint under https://api.infyrence.com/v1 requires this header, including GET /v1/models. The public status endpoint GET /v1/health/providers is the only exception.

Keep your key secret

An API key grants access to your account balance and usage. Treat it like a password.

Use your key only from server-side code. Do not embed it in browsers, mobile apps, or any client that ships to end users, and do not commit it to source control. Load it from an environment variable or a secrets manager instead.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.infyrence.com/v1",
    api_key=os.environ["INFYRENCE_API_KEY"],
)

If a key is exposed, revoke it in the dashboard and create a new one. A revoked key stops working, and any request that presents it receives a 401.

Authentication errors

If the Authorization header is missing, malformed, or presents a key that is unknown, revoked, or expired, the gateway responds with 401 and an error body of type authentication_error.

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "request_id": "4f0c2e1a-9b3d-4a2e-8c1f-77a0b2d5e6f1"
  }
}

string

A human-readable description of the problem.

string

The category of error. For authentication failures this is authentication_error.

string | null

A stable, machine-readable code when available, for example invalid_api_key.

string

The id of the failed request. It also appears in the X-Request-Id response header. Include it when contacting support.

Common causes of a 401:

Missing or malformed header

The Authorization header is absent or does not start with Bearer . Send Authorization: Bearer sk-....

Invalid key

The key does not match any key on your account. Confirm you copied the full sk-... value with no extra whitespace.

Revoked key

The key was revoked in the dashboard. Create a new key and update your app.

Expired key

The key passed its expiration date. Create a new key.

A 401 means the request was not authenticated. A different status, 402, means the request was authenticated but your account has no remaining platform balance. See Errors for the full list.

Next steps

List models

Call GET /v1/models for the live list of available models.

Create a chat completion

Send your first authenticated request.

Get started

Guides

API reference

Get your API key

Send the key

Keep your key secret

Authentication errors

Next steps

List models

Create a chat completion

​Get your API key

​Send the key

​Keep your key secret

​Authentication errors

​Next steps

List models

Create a chat completion

Get your API key

Send the key

Keep your key secret

Authentication errors

Next steps