OpenAI

Add the credential

Open Settings > Model Providers, click Add Model Provider and select OpenAI. Give the row a name, pick the organization, team or project it belongs to, and fill in:

Field	Value
`OPENAI_API_KEY`	Your OpenAI API key. Required unless you set a base URL.
`OPENAI_BASE_URL`	Optional. An OpenAI-compatible endpoint to call instead of `api.openai.com`.

Save the row. Every virtual key whose scope can see the row can now dispatch to it, unless the key restricts its providers. See Virtual keys.

The OpenAI model provider drawer with OPENAI_API_KEY filled in and OPENAI_BASE_URL empty — The OpenAI row: name, scope, the two credential fields and the routing handle.

With a base URL set, the gateway treats the row as an OpenAI-compatible endpoint and sends the key as Authorization: Bearer.

Model names

Write openai/<model>, for example openai/gpt-5-mini, openai/gpt-5 or openai/text-embedding-3-small. A bare gpt-5-mini also resolves to OpenAI when the key reaches an OpenAI row: the gateway infers OpenAI for names that start with gpt-, o1-, o3-, o4-, chatgpt-, text-embedding-, whisper- and tts-.

Send a request

curl https://gateway.langwatch.ai/v1/chat/completions \
  -H "Authorization: Bearer $LANGWATCH_VIRTUAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5-mini",
    "messages": [{"role": "user", "content": "Say hi in one word"}]
  }'

Endpoints

Endpoint	Served
`POST /v1/chat/completions`	Yes
`POST /v1/responses`	Yes
`POST /v1/messages`	Yes, translated from the Anthropic format
`POST /v1/embeddings`	Yes
`POST /v1/audio/speech`, `POST /v1/audio/transcriptions`	Yes
`POST /v1/images/generations`, `POST /v1/images/edits`	Yes, non-streaming. Not on a row that sets a base URL. See Images
`POST /v1/realtime/client_secrets`	Yes. See Realtime
`GET /v1/models`	Yes, from the OpenAI catalog

Prompt caching happens on OpenAI’s side. The cached token counts come back in usage and on the trace. See Cache control.

Last modified on September 6, 2026

Get Started

SDK Integration

Virtual Keys & Budgets

Billing & Metering

Governance

Providers

Features

API Reference

Self-Hosting

Cookbooks

Add the credential

Model names

Send a request

Endpoints

​Add the credential

​Model names

​Send a request

​Endpoints

Add the credential

Model names

Send a request

Endpoints