Get started with OpenRouter's unified API for hundreds of AI models. Learn how to integrate using OpenAI SDK, direct API calls, or third-party frameworks.

At a high level, OpenRouter normalizes the schema across models and providers so you only need to learn one. Here is the request schema as a TypeScript type. This will be the body of your POST request to the /api/v1/chat/completions endpoint (see the quick start above for an example).

Our API authenticates requests using Bearer tokens. This allows you to use curl or the OpenAI SDK directly with OpenRouter.

At its core, OpenRouter provides an OpenAI-compatible completion API that developers can leverage either through direct calls or by utilizing the OpenAI SDK. The base URL for all API interactions is 'https://openrouter.ai/api/v1'. When making requests, developers can enhance their application's ...

Select Model: Choose your desired model from the "Model" dropdown. (Optional) Custom Base URL: If you need to use a custom base URL for the OpenRouter API, check "Use custom base URL" and enter the URL.

When making requests to OpenRouter ↗, replace https://openrouter.ai/api/v1/chat/completions in the URL you are currently using with https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/openrouter/chat/completions.

Select Model: Choose your desired model from the "Model" dropdown. (Optional) Custom Base URL: If you need to use a custom base URL for the OpenRouter API, check "Use custom base URL" and enter the URL.

API Guides · Copy page · Sampling parameters shape the token generation process of the model. You may send any parameters from the following list, as well as others, to OpenRouter. OpenRouter will default to the values listed below if certain parameters are absent from your request (for example, temperature to 1.0).

August 14, 2025 - OpenRouter solves these problems with a set of connected features: One API key works with 400+ models from all major providers · Automatic switching to backup providers when your first choice fails · Side-by-side pricing for all models so you can compare costs instantly · Works with existing OpenAI code — just change the endpoint URL...

API Reference · Copy page · GET · https://openrouter.ai/api/v1/models/:author/:slug/endpoints · GET · /api/v1/models/:author/:slug/endpoints · Python · Try it · 200Retrieved · authorstringRequired · slugstringRequired · List of endpoints for the model ·

# recommended environment variables: apiKey: "${OPENROUTER_KEY}" # NOT OPENROUTER_API_KEY baseURL: "https://openrouter.ai/api/v1" models: default: ["meta-llama/llama-3-70b-instruct"] fetch: true titleConvo: true titleModel: "meta-llama/llam...

Select Model: Choose your desired model from the “Model” dropdown. (Optional) Custom Base URL: If you need to use a custom base URL for the OpenRouter API, check “Use custom base URL” and enter the URL.

This pull request introduces a new configuration option, openRouterBaseUrl, allowing users to specify a custom base URL for the OpenRouter provider. ... This change provides more flexibility for users who need to route OpenRouter API requests through a proxy or connect to a self-hosted or alternative OpenRouter-compatible endpoint.

To request the model, visit our Discord: https://discord.gg/fVyRaUDgxW

We cannot provide a description for this page right now

Requests with images, to multimodel models, are available via the /api/v1/chat/completions API with a multi-part messages parameter. The image_url can either be a URL or a base64-encoded image. Note that multiple images can be sent in separate content array entries. The number of images you can send in a single request varies per provider and per model. Due to how the content is parsed, we recommend sending the text prompt first, then the images. If the images must come first, we recommend putting it in the system prompt. OpenRouter supports both direct URLs and base64-encoded data for images:

API Reference · Copy page · GET · https://openrouter.ai/api/v1/generation · GET · /api/v1/generation · Python · Try it · 200Retrieved · Returns metadata about a specific generation request · AuthorizationBearer · Bearer authentication of the form Bearer <token>, where token is your ...

OpenRouter implements the OpenAI API specification for /completions and /chat/completions endpoints, allowing you to use any model with the same request/response format. Additional endpoints like /api/v1/models are also available. See our API documentation for detailed specifications. The API supports text, images, and PDFs. Images can be passed as URLs ...

DeepSeek R1 is here: Performance on par with [OpenAI o1](/openai/o1), but open-sourced and with fully open reasoning tokens. It's 671B parameters in size, with 37B active in an inference pass. Run R1 with API