Authentication

API Authentication

Using an API key

To use an API key, first create your key. Give it a name and you can optionally set a credit limit.

If you’re calling the OpenRouter API directly, set the Authorization header to a Bearer token with your API key.

If you’re using the OpenAI Typescript SDK, set the api_base to https://openrouter.ai/api/v1 and the apiKey to your API key.

1 import { OpenRouter } from '@openrouter/sdk';
2 
3 const openRouter = new OpenRouter({
4   apiKey: '<OPENROUTER_API_KEY>',
5   httpReferer: '<YOUR_SITE_URL>', // Optional. Site URL for rankings on openrouter.ai.
6   appTitle: '<YOUR_SITE_NAME>', // Optional. Site title for rankings on openrouter.ai.
7 });
8 
9 const completion = await openRouter.chat.send({
10   model: 'openai/gpt-5.2',
11   messages: [{ role: 'user', content: 'Say this is a test' }],
12   stream: false,
13 });
14 
15 console.log(completion.choices[0].message);

If your key has been exposed

You must protect your API keys and never commit them to public repositories.

OpenRouter is a GitHub secret scanning partner, and has other methods to detect exposed keys. If we determine that your key has been compromised, you will receive an email notification.

If you receive such a notification or suspect your key has been exposed, immediately visit your key settings page to delete the compromised key and create a new one.

Using environment variables and keeping keys out of your codebase is strongly recommended.

1	import { OpenRouter } from '@openrouter/sdk';
2
3	const openRouter = new OpenRouter({
4	apiKey: '<OPENROUTER_API_KEY>',
5	httpReferer: '<YOUR_SITE_URL>', // Optional. Site URL for rankings on openrouter.ai.
6	appTitle: '<YOUR_SITE_NAME>', // Optional. Site title for rankings on openrouter.ai.
7	});
8
9	const completion = await openRouter.chat.send({
10	model: 'openai/gpt-5.2',
11	messages: [{ role: 'user', content: 'Say this is a test' }],
12	stream: false,
13	});
14
15	console.log(completion.choices[0].message);