Quickstart - ngrok documentation

Making your first request

Open app.ngrok.ai and sign in with your ngrok account.

Purchase credits

Top-up at least $5.00. Every request you make requires ngrok.ai credits.

Create your access key

Open Access Keys and create a new key. Copy the key right away—it’s shown only once—and store it somewhere safe. It looks like ng-xxxxx-g1-xxxxx.

Make your first request

Point your OpenAI SDK at the gateway using your access key:

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://gateway.ngrok.ai/v1",
  apiKey: "ng-xxxxx-g1-xxxxx"
});

const res = await openai.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Hello, world!" }]
});

No need to sign up to OpenAI or bring your own keys for this request. ngrok.ai will handle the billing for you.

Next steps

Access keys: Understand how keys work and manage them

Credits: How usage is billed

SDK Integration: Connect with OpenAI, Anthropic, and other SDKs

Bring Your Own Keys: Use your own provider API keys for more providers

Use a model you run yourself: Connect Ollama, vLLM, LM Studio, or another private model.

​Making your first request

​Already have credits and an access key?

​Next steps

Making your first request

Already have credits and an access key?

Next steps