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

string

required

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

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.

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.

string

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

string

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

string

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

Response

Default catalog path (OpenAI shape)

string

Always list.

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)

array

Array of model objects in Anthropic format.

boolean

Always false — our catalog is returned in full.

string

ID of the first model in the list.

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"
    }
  ]
}

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