Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Openrouter API

Give your agents access to Openrouter API. Bring your own Openrouter key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Openrouter

Instant

OpenRouter is a unified API platform for accessing language models from various providers. It lets you easily integrate and switch between multiple LLMs with a single API.

122 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Openrouter without a separate account or API key for each one. New accounts start with $2 of free credit.

No Openrouter account or key

Your agent calls Openrouter through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

Billed at the selected model's OpenRouter token rate, from $0.02 per 1M input tokens and $0.04 per 1M output tokens; capped at $2 per call, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Openrouter with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Openrouter API to your AI assistant

Use Openrouter from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use OpenRouter through Composio Instant to summarize the main idea of photosynthesis in three sentences. Return the summary.

What success looks like

OPENROUTER_CREATE_CHAT_COMPLETION

Your assistant runs OpenRouter and replies with a three-sentence summary of the main idea of photosynthesis.

Runs on Composio Instant

SDK

Use the Openrouter API in your code

Call Openrouter from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
OPENROUTER_CREATE_CHAT_COMPLETION
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["openrouter"],
    instant={
        "toolkits": {"enable": ["openrouter"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "OPENROUTER_CREATE_CHAT_COMPLETION",
    arguments={
        "model": "openai/gpt-4o-mini",
        "messages": [
            {
                "role": "user",
                "content": "Summarize the main idea of photosynthesis in three sentences.",
            },
        ],
        "max_tokens": 120,
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["openrouter"],
  instant: {
    toolkits: { enable: ["openrouter"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "OPENROUTER_CREATE_CHAT_COMPLETION",
  {
    "model": "openai/gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "Summarize the main idea of photosynthesis in three sentences."
      }
    ],
    "max_tokens": 120
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": {
    "choices": [
      {
        "message": {
          "content": "<three-sentence summary>"
        }
      }
    ]
  },
  "error": null,
  "successful": true,
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Openrouter API tools

1 Openrouter tool runs on Instant, priced per call with no Openrouter key. Tools marked Your key need your own Openrouter account.

Action	Tool slug	What it does	Availability
Create Chat Completion	OPENROUTER_CREATE_CHAT_COMPLETION	Generate a chat completion from messages and a selected model.	InstantBilled at the selected model's OpenRouter token rate, from $0.02 per 1M input tokens and $0.04 per 1M output tokens; capped at $2 per call
Create Embeddings	OPENROUTER_CREATE_EMBEDDINGS	Create vector embeddings from text, tokens, or multimodal inputs.	Your key
Generate Image	OPENROUTER_GENERATE_IMAGE	Generate an image from a text prompt.	Your key
Create Speech	OPENROUTER_CREATE_SPEECH	Synthesize speech from text or multi-speaker turns.	Your key
Transcribe Audio	OPENROUTER_CREATE_TRANSCRIPTION	Convert audio into text with an OpenRouter speech-to-text model.	Your key
Generate Video	OPENROUTER_CREATE_VIDEO_GENERATION	Submit an asynchronous video generation job to OpenRouter.	Your key

Instant prices are Openrouter's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Openrouter API use cases and example prompts

Copy a prompt into your agent. Each one uses Openrouter with apps you connect through Composio.

Turn release notes into a launch brief
Use OpenRouter to turn the merged pull request descriptions in my Acme release on GitHub into customer-facing release notes. Save the draft in my Release Notes doc in Google Docs.
Apps used: Openrouter, GitHub, Google Docs
Summarize customer feedback
Use OpenRouter to review the support themes and customer comments in my Feedback Tracker in Google Sheets. Add a summary of recurring issues and suggested product fixes to the sheet, then post the main themes in Slack's #product channel.
Apps used: Openrouter, Google Sheets, Slack
Draft an account follow-up
Use OpenRouter to draft a follow-up based on the account notes and recent activity in the Acme company record in HubSpot. Create a Gmail draft that summarizes the relevant context and asks about next steps.
Apps used: Openrouter, HubSpot, Gmail
Build a support knowledge page
Use OpenRouter to turn the setup guide and troubleshooting notes in my Acme Launch folder in Google Drive into a support knowledge base page. Save the page in my Customer Support Handbook in Notion, with steps grouped by issue.
Apps used: Openrouter, Google Drive, Notion

TROUBLESHOOTING

Openrouter API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Raise max_tokens in OPENROUTER_CREATE_CHAT_COMPLETION to allow a longer response.

Connect your own OpenRouter key to use OPENROUTER_CREATE_TRANSCRIPTION. Add the terms to keyterms to bias recognition.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Openrouter account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Black Forest Labs

Api Key

Black Forest Labs provides hosted FLUX models for generating and editing images and videos. It offers fast, flexible media creation with asynchronous processing and fine-tuning support.

Deepgram

Api Key

Deepgram is an AI-powered speech recognition platform for accurate audio transcription and understanding. It enables fast, scalable speech-to-text with advanced audio intelligence features.

DeepSeek

Api Key

DeepSeek offers AI-powered chat, search, and language model services. It delivers advanced conversational and information retrieval tools for smarter workflows.

Fal.ai

Api Key

Fal.ai is a generative media platform offering 600+ AI models for images, video, voice, and audio. Developers use Fal.ai for fast, scalable access to cutting-edge generative AI tools.

Start with Openrouter.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Openrouter tool your agent needs.Free to start.

Start building

Openrouter API

What is Composio Instant?

No Openrouter account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Openrouter API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Openrouter API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Openrouter API tools

Openrouter API use cases and example prompts

Turn release notes into a launch brief

Summarize customer feedback

Draft an account follow-up

Build a support knowledge page

Openrouter API troubleshooting

Chat completions stop before the answer is complete

Transcription misses product names or domain terms

An action asks you to connect Openrouter

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Black Forest Labs

Deepgram

DeepSeek

Fal.ai

Start with Openrouter.It takes 30 seconds.