Never run out of credits
Turn on automatic top-up and ngrok.ai refills your balance from your saved card whenever it runs low. You choose when it tops up and how much, and you can cap how much it spends each billing period. See Automatic top-up.Approve card payments that need an extra check
Some banks ask you to confirm a payment before it goes through. When that happens while you buy credits, you now get a link to approve the payment, and your credits arrive once you do. See Credits.Requests can be up to 32 MiB
Requests larger than 32 MiB are now turned away with a clear error, before they reach a provider. Most requests are far below this. If you hit it, trim long conversation history or large embedded documents.Know when a setting didn’t reach the model
Not every model supports every setting. When the gateway has to leave a setting out because the model can’t use it, the response now tells you which ones. See Response headers.Long answers no longer get cut off
Streaming responses can now keep going for up to 15 minutes, which helps with long answers and slow reasoning models. If you’ve set your own total timeout, it still applies. See Streaming responses.Use more providers without signing up for them
You can now pay with credits for models from Google, DeepSeek, xAI, Moonshot AI, Z.ai, Qwen Cloud, MiniMax, and more, in addition to OpenAI and Anthropic. You don’t need an account or API key with those providers. The model catalog shows which models work this way.See why a fallback model didn’t run
If a model you listed as a fallback couldn’t be used, for example because your access key isn’t allowed to call it, the response now names it. See Response headers.Follow every retry for a request
You can now look up a single request and see each attempt the gateway made, what happened, and why it moved on. See Why a request failed over.Request ID, attempt count, and served model on every response
Gateway responses now state how the request was handled:Ngrok-AIG-Request-Id: the request’s ID, on every response including rejections and errors.Ngrok-AIG-Attempts: how many upstream attempts the gateway made.Ngrok-AIG-Model: the upstream model that produced the response.
generateContent and streamGenerateContent surface returns these headers too, where it previously returned only Content-Type.
Bodies on that surface are still forwarded byte-for-byte.The ai-gateway Traffic Policy action is retired
The AI Gateway no longer runs as a Traffic Policy action on your own endpoint. A policy that still contains theai-gateway action fails validation with ERR_NGROK_3820.- Send LLM traffic to
https://gateway.ngrok.aiwith an access key, and manage the gateway at app.ngrok.ai. - Existing credits were migrated to app.ngrok.ai automatically. No action is needed to keep your balance.
- Remove the
ai-gatewayaction from any endpoint that still carries it. - The action’s result variables, such as
actions.ngrok.ai_gateway, are gone. Read the response headers and the Usage API instead.
app.ngrok.ai and gateway.ngrok.ai
Manage your AI Gateway from app.ngrok.ai and send traffic to a shared gateway URL:- Manage access keys, access key configurations, provider keys, credits, and settings at app.ngrok.ai.
- Send LLM traffic from your applications to
https://gateway.ngrok.aiwith an access key only—provider keys are stored server-side. - Updated the Quickstart, Overview, How It Works, and Access Keys.
- Provider keys are now account-scoped in app.ngrok.ai BYOK.
- Endpoint-based Traffic Policy setup is deprecated.
AI Gateway API keys & credits
You can now authenticate requests to your AI Gateway with AI Gateway API Keys—no provider accounts needed. The AI Gateway manages the provider keys for OpenAI and Anthropic on your behalf. Purchase prepaid credits to fund usage.- AI Gateway API Keys: Create keys to authenticate requests
- Credits: Understand pricing and balance management
- Bring Your Own Keys: Use your own provider keys for additional providers
- Updated Quickstart, Overview, and all SDK guides to use AI Gateway API Keys as the primary path
Native Anthropic SDK support
Use Anthropic’s official Python and TypeScript SDKs directly with the AI Gateway. The gateway now supports the native/v1/messages API format alongside the OpenAI-compatible format. See the Anthropic SDK guide for setup instructions.Groq provider support
Groq is now a built-in provider. Access Llama and Mixtral models running on Groq’s LPU hardware with automatic failover and observability.Expanded model catalog
Added new providers to the model catalog: Hyperbolic, InceptionLabs, Inference.net, and OpenRouter. Updated model aliases and provider-specific model IDs for improved compatibility.Early access release
Initial Early Access release of the AI Gateway.Features
- OpenAI-compatible API for routing requests to multiple AI providers
- Support for OpenAI, Anthropic, Google, and other providers
- Multi-provider failover across models, providers, and API keys
- Multi-key failover per provider
- CEL-based model selection strategies
- Custom provider support via internal endpoints
- Token counting and usage metrics