List Models

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..."

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "anthropic-version: 2023-06-01"

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "X-Toolken-Provider: openai" \
  -H "Authorization: Bearer sk-..."

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "X-Toolken-Provider: anthropic" \
  -H "x-api-key: sk-ant-..."

from openai import OpenAI

client = OpenAI(
    base_url="https://gateway.toolken.ai/v1",
    api_key="unused",
    default_headers={"X-Toolken-Key": "tk_live_..."},
)
client.models.list()

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gateway.toolken.ai/v1",
  apiKey: "unused",
  defaultHeaders: { "X-Toolken-Key": "tk_live_..." },
});
await client.models.list();

{
  "object": "list",
  "data": [
    {
      "id": "claude-3-5-sonnet-20241022",
      "object": "model",
      "created": 1715367049,
      "owned_by": "anthropic"
    },
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715368132,
      "owned_by": "openai"
    }
  ]
}

GET

models

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..."

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "anthropic-version: 2023-06-01"

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "X-Toolken-Provider: openai" \
  -H "Authorization: Bearer sk-..."

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "X-Toolken-Provider: anthropic" \
  -H "x-api-key: sk-ant-..."

from openai import OpenAI

client = OpenAI(
    base_url="https://gateway.toolken.ai/v1",
    api_key="unused",
    default_headers={"X-Toolken-Key": "tk_live_..."},
)
client.models.list()

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gateway.toolken.ai/v1",
  apiKey: "unused",
  defaultHeaders: { "X-Toolken-Key": "tk_live_..." },
});
await client.models.list();

{
  "object": "list",
  "data": [
    {
      "id": "claude-3-5-sonnet-20241022",
      "object": "model",
      "created": 1715367049,
      "owned_by": "anthropic"
    },
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715368132,
      "owned_by": "openai"
    }
  ]
}

Returns the list of models available through the gateway. Default behavior (no X-Toolken-Provider): responds with our own catalog of all supported models. The response is OpenAI-compatible by default. If your request includes an Anthropic hint header (anthropic-version or anthropic-beta), the same catalog is returned in Anthropic-compatible format instead. Only X-Toolken-Key is required — no provider key needed. With X-Toolken-Provider: <slug>: passes the request through to that provider’s live model list endpoint. This path requires both X-Toolken-Key and your provider BYOK auth header.

Headers

X-Toolken-Key

string

required

Your Toolken API key. Validated by the gateway and stripped before forwarding.

X-Toolken-Provider

string

Pin to a specific provider (e.g. openai, anthropic, gemini, mistral). When set, the gateway passes the request through to that provider’s live model list. Omit to use our catalog instead.

Authorization

string

Your provider key in Bearer format (BYOK), e.g. Bearer sk-.... Required only for the provider-passthrough path (X-Toolken-Provider set). Forwarded untouched, never stored.

x-api-key

string

Anthropic API key. Used instead of Authorization when routing to Anthropic. Required only for the provider-passthrough path with X-Toolken-Provider: anthropic.

anthropic-version

string

If included, the catalog response is returned in Anthropic-compatible format (no X-Toolken-Provider needed). Forwarded to the provider on passthrough paths.

anthropic-beta

string

Same as anthropic-version — triggers Anthropic-shaped response for the default catalog path.

Response

Default catalog path (OpenAI shape)

object

string

Always list.

data

array

Array of model objects. Each has id (model name), object (model), created (Unix timestamp), and owned_by (provider slug).

Default catalog path (Anthropic shape, when `anthropic-version` / `anthropic-beta` is present)

data

array

Array of model objects in Anthropic format.

has_more

boolean

Always false — our catalog is returned in full.

first_id

string

ID of the first model in the list.

last_id

string

ID of the last model in the list.

Provider-passthrough path

Response shape is determined by the upstream provider and forwarded verbatim.

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..."

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "anthropic-version: 2023-06-01"

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "X-Toolken-Provider: openai" \
  -H "Authorization: Bearer sk-..."

curl https://gateway.toolken.ai/v1/models \
  -H "X-Toolken-Key: tk_live_..." \
  -H "X-Toolken-Provider: anthropic" \
  -H "x-api-key: sk-ant-..."

from openai import OpenAI

client = OpenAI(
    base_url="https://gateway.toolken.ai/v1",
    api_key="unused",
    default_headers={"X-Toolken-Key": "tk_live_..."},
)
client.models.list()

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gateway.toolken.ai/v1",
  apiKey: "unused",
  defaultHeaders: { "X-Toolken-Key": "tk_live_..." },
});
await client.models.list();

{
  "object": "list",
  "data": [
    {
      "id": "claude-3-5-sonnet-20241022",
      "object": "model",
      "created": 1715367049,
      "owned_by": "anthropic"
    },
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715368132,
      "owned_by": "openai"
    }
  ]
}

Images Toolken API

Gateway API

AI Gateway

Models

Toolken API

Headers

Response

Default catalog path (OpenAI shape)

Default catalog path (Anthropic shape, when `anthropic-version` / `anthropic-beta` is present)

Provider-passthrough path

​Headers

​Response

​Default catalog path (OpenAI shape)

​Default catalog path (Anthropic shape, when anthropic-version / anthropic-beta is present)

​Provider-passthrough path

Headers

Response

Default catalog path (OpenAI shape)

Default catalog path (Anthropic shape, when `anthropic-version` / `anthropic-beta` is present)

Provider-passthrough path