Quickstart

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.

Concepts

Getting Started With

SDKs

Guides

Observability

Examples

Reference

API Reference

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

Making your first request

Already have credits and an access key?

Next steps