OpenRouter: uma API unificada para vários modelos de IA

OpenRouter oferece aos desenvolvedores um catálogo comum e uma camada de API para escolher diferentes modelos e provedores de IA. O site apresenta modelos de texto, imagem, vídeo e áudio, além de integração por API, SDKs de cliente e Agent SDK. Capacidades, preços, limites de contexto, disponibilidade regional e políticas dos provedores variam. Antes de integrar, consulte o catálogo de modelos, a documentação oficial e a página de preços.

Recursos principais

• API e catálogo unificados: consulte e chame modelos disponíveis por uma API. O catálogo mostra descrições e preços atuais; também é possível listar modelos pela API.
• Compatibilidade com OpenAI SDK: a documentação oficial descreve um caminho de integração. A migração ainda exige configurar o endereço-base da OpenRouter, a chave e o identificador do modelo, além de verificar os parâmetros suportados.
• SDKs de cliente e Agent SDK: há SDKs de cliente para JavaScript/TypeScript e Python. O Agent SDK ajuda a criar fluxos com chamadas de ferramentas, ciclos de conversa e gerenciamento de estado. Consulte a documentação da versão usada.
• Roteamento e alternativas: opções de roteamento e fallback podem ajudar em problemas de disponibilidade. O comportamento depende da solicitação, do endpoint e do plano; não garante o menor preço nem continuidade em todos os casos.
• Cobrança por modelo: a inferência é cobrada pela tarifa publicada do modelo escolhido. Planos podem diferir em taxas, acesso a modelos, orçamento e outros recursos. Verifique os detalhes atuais antes de enviar solicitações.
• Controles de dados: a OpenRouter documenta políticas diferentes para cada provedor e permite filtrar provedores por conta ou solicitação. Antes de enviar dados sensíveis, confira a política do provedor selecionado e as opções de privacidade da conta.

Como começar

1. Crie uma conta e consulte planos, catálogo, cobrança e políticas de dados atuais.
2. Crie uma chave API no painel e guarde-a em variável de ambiente ou gerenciador de segredos. Não a inclua no repositório, em aplicativos cliente ou em logs.
3. Escolha um modelo e leia requisitos de entrada, saída, ferramentas e modalidades. Para OpenAI SDK, siga as instruções oficiais para baseURL, chave e nome do modelo.
4. Teste formato da solicitação, cobrança, tratamento de erros e fallbacks opcionais com dados não sensíveis antes de usar conteúdo real.
5. Defina orçamento ou limite para as chaves e acompanhe uso, cobranças e políticas dos provedores.

Usos e limites

OpenRouter pode ser útil para desenvolvedores que querem administrar várias opções de modelos por uma API. Também permite comparar modelos, criar fluxos de chat ou agentes e chamar modelos compatíveis de imagem ou áudio. Ferramentas, saída estruturada e multimodalidade dependem do modelo e do endpoint. A interface unificada reduz algumas diferenças de integração, mas não elimina diferenças de parâmetros, preço, limites ou comportamento. Não há garantia de latência fixa, precisão ou disponibilidade.

As solicitações seguem para o modelo e o provedor escolhidos. As configurações de dados da OpenRouter e as políticas dos provedores são etapas diferentes. Antes de enviar código, dados de clientes ou informações pessoais, verifique retenção, treinamento, região e logs. Valide as respostas de IA na aplicação. Os custos variam conforme o modelo e as condições do serviço; inclua erros e fallbacks no planejamento de custos e nos testes.

Perguntas frequentes

O que é OpenRouter?

É uma plataforma de API multimodelo com catálogo, API unificada e ferramentas de desenvolvimento, como SDKs. O catálogo atual informa modelos e endpoints disponíveis.

Posso usar OpenAI SDK?

A documentação oficial descreve uma integração compatível. Em geral, é preciso configurar baseURL, chave API e modelo, e confirmar que o modelo aceita os parâmetros necessários.

Como o uso é cobrado?

A inferência segue a tarifa publicada do modelo; os planos podem ter taxas ou recursos diferentes. Consulte os preços e os dados de cobrança atuais.

Como os dados das solicitações são tratados?

A OpenRouter e cada provedor têm políticas próprias. Confira opções de logs, uso de dados e filtro de provedores na conta, além das regras de retenção do provedor escolhido.