API endpoint

Supported model API surfaces (relative to the base URL below):

Status	Method	Path	Use for
Supported	`GET`	`/models`	List discoverable model ids available to your key
Supported	`GET`	`/models?client_version=…`	Codex remote model picker
Supported	`GET`	`/models/user`	Claude Code gateway model picker
Supported	`POST`	`/chat/completions`	Chat and reasoning models (primary)
Supported	`POST`	`/embeddings`	Embedding models
Supported	`POST`	`/rerank`	Rank documents for a query with an assigned model
Supported	`POST`	`/audio/transcriptions`	Transcribe an audio file sent as multipart form data
Supported	`POST`	`/audio/speech`	Generate speech as a binary audio stream
Supported	`POST`	`/messages`	Anthropic Messages API shape, including agent clients such as Claude Code
Supported	`POST`	`/responses`	OpenAI Responses API, including agent clients such as Codex

Streaming works on chat-style paths (stream: true). Which models exist, their pricing, and availability are live on the Models catalog — not duplicated here.

Decision models are not OpenAI- or Anthropic-compatible and are served outside /v1; see Decision API.

Rerank requests use model, query, and documents, with optional top_n and return_documents. Responses contain results with document indexes and relevance scores. Use an explicitly assigned model ID. A hidden model does not appear in /models, even for an authorized key. Rerank does not stream.

Transcription requests use multipart/form-data with model and file fields. Speech requests use JSON with model, input, and voice. Successful speech responses stream audio bytes and preserve Content-Type. Both audio paths use your Tokener.ai API key. Model-specific formats and limits still apply.

Base URL

https://api.tokener.ai/v1

All model traffic uses this base URL. It exposes OpenAI-compatible endpoints and an Anthropic-compatible /messages endpoint. The website and console never proxy LLM calls. Send your Tokener.ai API key as the Bearer token, or as x-api-key for /messages.

TypeScript

import OpenAI from "openai";
 
const client = new OpenAI({
  apiKey: process.env.TOKENER_API_KEY,
  baseURL: "https://api.tokener.ai/v1",
});

Create a key in API keys before calling these paths.

Agent clients

Coding agents run directly against these paths. See the setup guides for Codex (/responses) and Claude Code (/messages).

Every response — success or error — carries x-request-id and request-id headers; include them when contacting support. There is no browser CORS support: call these paths from your backend, not directly from a browser. See Errors for error response shapes and the full error code table.