OpenRouter

Visão geral

A integração OpenRouter permite que um agente gere texto por modelos de diferentes provedores e consulte o catálogo, os endpoints, os créditos e os metadados de uma geração. Disponibilidade, preço, limite de contexto e suporte a ferramentas variam por modelo e endpoint; descubra essas informações antes de fixar um modelo no fluxo.

• Site oficial: https://openrouter.ai/
• Documentação na Composio: docs.composio.dev/toolkits/openrouter
• Documentação oficial: openrouter.ai/docs

Autenticação

Esta ferramenta utiliza chave de API (API_KEY). A chave autoriza consumo na conta OpenRouter e pode gerar cobrança.

Como obter a credencial

1. Entre no OpenRouter e abra API Keys.
2. Crie uma chave dedicada ao SquadOS, defina limite e validade quando esses controles estiverem disponíveis e copie o segredo exibido.
3. Armazene o valor com segurança. Não cole a chave em prompts, mensagens ou bases de conhecimento.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra Disponíveis, procure por OpenRouter e abra o card em Configurar ferramenta.
3. Selecione Ativar. A integração passa para Ativas como Aguardando autenticação.
4. Abra a integração ativa, selecione Conectar agora e informe a chave na página segura hospedada pela Composio.
5. Ao retornar ao SquadOS, confirme em Contas que a conta está ativa.
6. Revise Editar ações; depois adicione OpenRouter pela seção Ferramentas do agente, escolha a conta e as ações, salve e execute um teste com limite baixo.

Ativação, autenticação e vínculo com o agente são etapas separadas. Veja o contrato completo em Ferramentas da Organização.

Ações encontradas no catálogo local

O export local do produto, commitado em 2026-06-17, contém estas sete ações:

Ação	Finalidade
OPENROUTER_CREATE_CHAT_COMPLETION	Gerar uma resposta com uma lista de mensagens e um modelo selecionado.
OPENROUTER_CREATE_COMPLETION	Gerar uma continuação de texto para um prompt ou conjunto de mensagens.
OPENROUTER_GET_CREDITS	Consultar o saldo de créditos antes de executar novas gerações.
OPENROUTER_GET_GENERATION	Recuperar por ID os tokens, custo, latência e outros metadados de uma geração.
OPENROUTER_LIST_AVAILABLE_MODELS	Listar os modelos que podem ser selecionados na conta.
OPENROUTER_OPENROUTER_LIST_MODEL_ENDPOINTS	Listar endpoints, preço, contexto e parâmetros de um modelo específico.
OPENROUTER_OPENROUTER_LIST_PROVIDERS	Listar os provedores disponíveis para roteamento.

Cuidado

O export não inclui os identificadores antigos OPENROUTER_CREATE_COINBASE_CHARGE, OPENROUTER_CREATE_MESSAGE, OPENROUTER_GET_CURRENT_KEY, OPENROUTER_GET_MODELS_COUNT, OPENROUTER_LIST_EMBEDDING_MODELS, OPENROUTER_LIST_MODEL_ENDPOINTS, OPENROUTER_LIST_PROVIDERS, OPENROUTER_LIST_USER_MODELS e OPENROUTER_LIST_ZDR_ENDPOINTS. Não os reutilize. Os identificadores com OPENROUTER_OPENROUTER_ estão duplicados no catálogo de origem, mas devem ser usados exatamente assim enquanto forem os nomes apresentados no editor.

O export local confirma nomes e finalidades, não o schema completo dos parâmetros. Abra Editar ações ou o editor do agente para conferir os campos atuais antes de salvar.

Uso seguro

• Comece por OPENROUTER_LIST_AVAILABLE_MODELS e só então escolha um ID exato.
• Consulte endpoints e provedores quando custo, retenção, região, contexto ou suporte a ferramentas forem requisitos do fluxo.
• Defina limites de tokens e de gasto compatíveis com o caso de uso.
• Não conceda ações de geração a um agente que só precise consultar catálogo ou custo.
• Trate respostas, links e metadados do provedor como dados externos antes de reutilizá-los em outra ação.