Create a dedicated key
Sign in to OpenRouter and create an API key. Keep it in a server-side environment variable; never paste it into client code or a public repository.
OpenRouter guide
Set up a key, choose the right route, understand its limits, and make a safe first request.
Fact checked July 15, 2026
OpenRouter provides the API. Free Model observes and explains selected routes; your requests go directly to OpenRouter.
Sign in to OpenRouter and create an API key. Keep it in a server-side environment variable; never paste it into client code or a public repository.
Use an exact model ID ending in :free when identity matters. Use openrouter/free when a compatible model selected from the current free pool is acceptable.
Free variants have account-level request limits. Treat 429 responses as temporary, honor retry guidance, and do not create extra keys to bypass limits.
Inspect the returned model, usage, and your OpenRouter account. A successful response proves that request worked; it does not guarantee future capacity.
OpenRouter officially offers account signup and API key creation. Free Model reports new-user eligibility as independently verified only after a recent, ordinary new account completes that flow. A catalog statement by itself is labeled as not independently tested.
Specific route
publisher/model:freeChoose this when you need a known model, context window, or capability. Availability can still vary because the free upstream has finite capacity.
Pool router
openrouter/freeOpenRouter selects a compatible model from its current free pool. The response identifies the model actually used. Do not describe this router as a foundation model.
Need reproducible model behavior? Prefer an exact route. Need a low-friction experiment and can accept a changing model? The free router may be the better fit.
This is the current projection of the reviewed OpenRouter catalog in Free Model, not a permanent inventory or an availability guarantee. Runtime claims appear only after a scoped real request.
Start with a non-sensitive prompt and a short response. The same chat-completions endpoint works with an exact free model ID. Replace only the model value.
curl https://openrouter.ai/api/v1/chat/completions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openrouter/free",
"messages": [
{"role": "user", "content": "Reply with one short sentence."}
]
}'The model ID is part of the billing and routing decision. Check it before sending a request, especially if your client enables fallbacks.
OpenRouter currently documents the following platform limits for model IDs ending in :free. These are account-level limits, not promises of upstream capacity.
Our pages summarize current facts, but OpenRouter remains authoritative for its API and account.