baseURL at Verlon and swap the API key.
Chat models
| Model ID | Type | Context |
|---|---|---|
chat-latest | chat | 1000K |
gpt-3.5-turbo | chat | 16K |
gpt-3.5-turbo-0125 | chat | 16K |
gpt-3.5-turbo-1106 | chat | 16K |
gpt-3.5-turbo-16k | chat | 16K |
gpt-4 | chat | 8K |
gpt-4-0613 | chat | 8K |
gpt-4-1-2025-04-14 | chat | 1048K |
gpt-4-turbo | chat | 128K |
gpt-4-turbo-2024-04-09 | chat | 128K |
gpt-4.1 | chat | 1048K |
gpt-4.1-2025-04-14 | chat | 1048K |
gpt-4.1-mini | chat | 1048K |
gpt-4.1-mini-2025-04-14 | chat | 1048K |
gpt-4.1-nano | chat | 1048K |
gpt-4.1-nano-2025-04-14 | chat | 1048K |
gpt-4o | chat | 128K |
gpt-4o-2024-05-13 | chat | 128K |
gpt-4o-2024-08-06 | chat | 128K |
gpt-4o-2024-11-20 | chat | 128K |
gpt-4o-mini | chat | 128K |
gpt-4o-mini-2024-07-18 | chat | 128K |
gpt-4o-mini-realtime-preview | chat | 128K |
gpt-4o-mini-realtime-preview-2024-12-17 | chat | 128K |
gpt-4o-mini-search-preview | chat | 128K |
gpt-4o-mini-search-preview-2025-03-11 | chat | 128K |
gpt-4o-realtime-preview | chat | 128K |
gpt-4o-search-preview | chat | 128K |
gpt-4o-search-preview-2025-03-11 | chat | 128K |
gpt-5-chat-latest | chat | 128K |
gpt-5-nano | chat | 128K |
gpt-5-nano-2025-08-07 | chat | 128K |
gpt-5-pro | chat | 128K |
gpt-5-pro-2025-10-06 | chat | 128K |
gpt-5-search-api | chat | 128K |
gpt-5-search-api-2025-10-14 | chat | 128K |
gpt-5.1 | chat | 128K |
gpt-5.1-2025-11-13 | chat | 128K |
gpt-5.1-chat-latest | chat | 128K |
gpt-5.2 | chat | 128K |
gpt-5.2-2025-12-11 | chat | 128K |
gpt-5.2-chat-latest | chat | 128K |
gpt-5.2-codex | chat | 128K |
gpt-5.3-chat-latest | chat | 128K |
gpt-5.3-codex | chat | 128K |
gpt-5.4 | chat | 128K |
gpt-5.4-2026-03-05 | chat | 128K |
gpt-5.4-mini | chat | 128K |
gpt-5.4-mini-2026-03-17 | chat | 128K |
gpt-5.4-nano | chat | 128K |
gpt-5.4-nano-2026-03-17 | chat | 128K |
gpt-5.4-pro | chat | 128K |
gpt-5.4-pro-2026-03-05 | chat | 128K |
gpt-5.5 | chat | 1000K |
gpt-5.5-2026-04-23 | chat | 1000K |
gpt-5.5-pro | chat | 1000K |
o1 | chat | 200K |
o1-2024-12-17 | chat | 200K |
o1-mini | chat | 200K |
o1-preview | chat | 200K |
o3 | chat | 200K |
o3-2025-04-16 | chat | 200K |
o3-mini | chat | 200K |
o3-mini-2025-01-31 | chat | 200K |
o4-mini | chat | 200K |
o4-mini-2025-04-16 | chat | 200K |
This table is auto-generated from the Verlon model registry on every sync — see the live registry for pricing, benchmarks, and deprecation dates. Any model listed here is available today.
Other modalities
- audio — 13 models
- embeddings — 3 models
- image generation — 6 models
- moderation — 2 models
- speech-to-text — 7 models
- text-to-speech — 7 models
- video generation — 2 models
Quickstart
First time? Create a gate and grab an API key — the examples below need a
GATE_ID and VERLON_API_KEY.gpt-4o for gpt-5.4, o4-mini, o1-preview, or any other ID.
SDK compatibility
Verlon exposes an OpenAI-compatible endpoint. The official OpenAI SDK works unchanged — you swap two lines and every model in the table above becomes callable via the SDK you already know.Configuration — just two lines
Specifying your gate
Verlon supports three ways to point a request at a gate:- Using gateId (Recommended)
- Using model field
- Using a default header
Requires
@ts-ignore in TypeScript, but the clearest intent.Streaming
Identical behavior to the OpenAI SDK —stream: true returns an async iterable.
Language coverage
What’s supported
Streaming
Streaming
Full support for
stream: true, identical semantics to OpenAI.Tool / function calling
Tool / function calling
Fully supported. Verlon translates across providers if your gate routes to Claude, Gemini, etc.
Vision
Vision
Image inputs (
type: 'image_url') work with any vision-capable model.Standard parameters
Standard parameters
temperature, max_tokens, top_p, frequency_penalty, presence_penalty, logprobs, and the rest — all passed through.Usage + cost tracking
Usage + cost tracking
Standard
response.usage with token counts, plus Verlon’s cost field with per-call dollar amount.Responses API
Verlon is also a drop-in for OpenAI’s Responses API (client.responses.create) — the surface the OpenAI Agents SDK and multi-turn tool loops with encrypted reasoning replay are built on. Point baseURL at Verlon and pass your gate id as model, exactly like chat completions.
Multi-turn tool loops with reasoning replay work. On each turn, echo the
prior
reasoning and function_call items back in input — Verlon requests
include: ['reasoning.encrypted_content'] for reasoning models and passes the
encrypted reasoning through untouched, so the model keeps its chain of thought
across tool calls.Stateless only (v1)
Stateless only (v1)
store: true and previous_response_id are not supported — Verlon
holds no server-side conversation state (matching our zero-data-retention
default). Send the full input each turn, echoing prior reasoning /
function_call items back. Requests using store: true or
previous_response_id return 400.OpenAI-backed gates only
OpenAI-backed gates only
The Responses API is OpenAI-specific. A gate that resolves to Anthropic,
Google, or Mistral returns
400 — use /v1/chat/completions for those,
which normalizes tool calls across providers.Streaming
Streaming
stream: true returns the named-event SSE stream (event: response.created,
response.output_text.delta, response.completed, …) verbatim.Migrating an existing OpenAI app
Add a gate reference
Pass
gateId (or set the default header). The model field, messages, and everything else stay the same.How it works
- You send an OpenAI-format request to
https://api.verlon.ai/v1/chat/completions - Verlon receives — validates the gate, applies routing rules
- Verlon routes to whichever model your gate points at (GPT, Claude, Gemini, Mistral, or anything else in the registry)
- The provider responds in its native format
- Verlon normalizes back to OpenAI format
- You receive a standard OpenAI response with an added
costfield
Errors
Errors come back OpenAI-shaped —{ "error": { "message", "type", "code", "param" } } — so the OpenAI SDK’s error classes work unchanged.
| Status | Meaning | What to check |
|---|---|---|
400 | Invalid request | Malformed body or missing gateId |
401 | Invalid API key | Your VERLON_API_KEY value and the Authorization: Bearer header |
404 | Gate not found | Your GATE_ID — the error message names the offending ID |
429 | Rate limit exceeded | Back off and retry; the body includes reset_at, and every response carries X-RateLimit-* headers |
FAQ
Do I need to change my request code?
Do I need to change my request code?
No. Change
baseURL + apiKey in the client. The completion calls stay identical.Can I still call OpenAI directly?
Can I still call OpenAI directly?
Yes. Revert
baseURL + apiKey to OpenAI values and you’re back on their API.Can I route a Claude or Gemini model through the OpenAI SDK?
Can I route a Claude or Gemini model through the OpenAI SDK?
Yes — that’s the point. Configure your gate to route to any model in the registry and your OpenAI SDK code stays the same.
Does the Vercel AI SDK work?
Does the Vercel AI SDK work?
Yes. Its OpenAI adapter works against Verlon’s endpoint unchanged.
Do I need the Verlon SDK?
Do I need the Verlon SDK?
No. This whole guide uses only the OpenAI SDK.
Full non-chat model list
Every non-chat OpenAI model Verlon routes to, grouped by modality. Chat models are in the table near the top of this page.Audio
| Model ID |
|---|
gpt-4o-audio-preview |
gpt-4o-audio-preview-2024-12-17 |
gpt-4o-audio-preview-2025-06-03 |
gpt-4o-mini-audio-preview |
gpt-4o-mini-audio-preview-2024-12-17 |
gpt-audio |
gpt-audio-1.5 |
gpt-audio-2025-08-28 |
gpt-audio-mini |
gpt-audio-mini-2025-10-06 |
gpt-audio-mini-2025-12-15 |
gpt-realtime-2 |
gpt-realtime-translate |
Embeddings
| Model ID |
|---|
text-embedding-3-large |
text-embedding-3-small |
text-embedding-ada-002 |
Image generation
| Model ID |
|---|
chatgpt-image-latest |
gpt-image-1 |
gpt-image-1-mini |
gpt-image-1.5 |
gpt-image-2 |
gpt-image-2-2026-04-21 |
Moderation
| Model ID |
|---|
omni-moderation-2024-09-26 |
omni-moderation-latest |
Speech-to-text
| Model ID |
|---|
gpt-4o-mini-transcribe |
gpt-4o-mini-transcribe-2025-03-20 |
gpt-4o-mini-transcribe-2025-12-15 |
gpt-4o-transcribe |
gpt-4o-transcribe-diarize |
gpt-realtime-whisper |
whisper-1 |
Text-to-speech
| Model ID |
|---|
gpt-4o-mini-tts |
gpt-4o-mini-tts-2025-03-20 |
gpt-4o-mini-tts-2025-12-15 |
tts-1 |
tts-1-1106 |
tts-1-hd |
tts-1-hd-1106 |
Video generation
| Model ID |
|---|
sora-2 |
sora-2-pro |
Related
- Anthropic · Google · Mistral
- Verlon SDK reference — full-feature native SDK for new projects
- Gates — set up routing rules and model configuration
- Bring your own key — use your own OpenAI account for provider costs
- OpenAI’s official docs ↗

