Skip to main content

gateway.ngrok.ai

When troubleshooting issues with the current AI Gateway at https://gateway.ngrok.ai:
  1. Check the error code and message in the response body. See Error Codes.
  2. Verify your app sends an access key—not an upstream provider key.
  3. Confirm the access key’s configuration allows the provider and model you requested, with routing credentials attached.
  4. Review usage in Observability.
Common fixes:
SymptomCheck
401 UnauthorizedAccess key missing, malformed, or deleted
403 ForbiddenCredits exhausted — purchase credits
No API key found (3802)Configuration missing routing rule or provider keys for the requested provider
Model selection failed (3803)Model or provider blocked by configuration access scope
See Error Handling for retry and failover behavior.

Legacy endpoint setup

If you still run the AI Gateway as a Traffic Policy action on a custom ngrok endpoint, action result variables like ${actions.ngrok.ai_gateway} are available in Traffic Policy expressions. See Migrating from endpoints to move to gateway.ngrok.ai.