Guia da API key do OpenRouter

OpenRouter API key: como pegar e usar os modelos grátis

Crie a sua API key do OpenRouter, veja os limites dos modelos grátis, resolva os erros 401, 402 e 429 e use o OpenRouter no iPhone, no Android ou na web.

Atualizado em
  • Para pegar uma API key (chave de API) do OpenRouter, entre em openrouter.ai, abra openrouter.ai/keys e crie uma chave; ela começa com "sk-or-v1-". Criar a chave é grátis, os modelos cujo ID termina em ":free" podem ser usados dentro de limites diários, e todos os outros são pagos com créditos pré-pagos.
  • O OpenRouter é uma conta e uma chave para modelos de muitas empresas de IA. Ele não publica um app de chat próprio para iPhone ou Android, então no celular você usa um app de chat que aceite uma chave do OpenRouter, como o Oriveo.
  • Em 18 de novembro de 2026, os modelos grátis permitem 20 solicitações por minuto e 50 por dia, ou 1.000 por dia depois que você compra pelo menos 10 créditos. O erro 402 quer dizer que os seus créditos acabaram.
Oriveo no iPhone: a tela de provedores, com os provedores que você conectou e o gasto deste mês.

O que é o OpenRouter e o que é uma API key?

O OpenRouter é um serviço que dá acesso a modelos de muitas empresas de IA com uma única conta. Em vez de se cadastrar em cada empresa, você coloca créditos no OpenRouter uma vez e escolhe os modelos na lista dele.

A API key é o código secreto que um app usa para fazer solicitações na sua conta. O OpenRouter confere a chave, envia a sua mensagem ao modelo que você escolheu e desconta o custo dos seus créditos no OpenRouter.

O OpenRouter foi feito para apps e desenvolvedores. Ele não publica um app de chat próprio para iPhone ou Android, e é por isso que tanta gente procura um "app do OpenRouter". O que você precisa, na verdade, é de um app de chat que aceite uma chave do OpenRouter.

Como pegar uma API key do OpenRouter?

Leva uns dois minutos no site do OpenRouter.

  • Acesse openrouter.ai e crie uma conta, ou entre na sua.
  • Abra a página de chaves em openrouter.ai/keys e crie uma nova chave. Dê a ela o nome do app ou do aparelho em que vai usá-la.
  • Copie a chave. As chaves do OpenRouter começam com "sk-or-v1-" e têm 73 caracteres, então confira se você copiou tudo.
  • Se quiser usar modelos que não são grátis, adicione créditos na página Credits.
  • Guarde a chave em um lugar seguro, como um gerenciador de senhas. Se ela vazar, apague-a na página de chaves e crie outra.

A API do OpenRouter é grátis?

Em parte. Criar conta e chave não custa nada, e o OpenRouter oferece modelos grátis cujo ID termina em ":free". Todo o resto é pago com créditos pré-pagos. O OpenRouter também diz que usuários novos recebem um pouco de crédito grátis, mas não informa quanto.

Os modelos grátis têm limites. Estes são os limites publicados pelo OpenRouter em 18 de novembro de 2026:

  • Se o seu saldo ficar negativo, o OpenRouter avisa que até os modelos grátis podem retornar erro.
  • O site do OpenRouter mostra quais modelos têm versão ":free" no momento; confira lá antes de depender de um deles.
A API do OpenRouter é grátis?
Sua contaSolicitações por minuto em modelos grátisSolicitações por dia em modelos grátis
Comprou menos de 10 créditos no total2050
Comprou pelo menos 10 créditos no total201.000

Como funcionam os créditos do OpenRouter?

O OpenRouter é pré-pago. Você compra créditos na página Credits com cartão ou com uma das outras formas de pagamento listadas lá, e cada solicitação é descontada desses créditos. Em 18 de novembro de 2026, os termos do OpenRouter definem uma compra mínima de $5, cobram uma taxa de pagamento e dizem que créditos não usados podem expirar 365 dias depois da compra. Veja os detalhes atuais em openrouter.ai/terms.

Cada modelo tem o próprio preço por token, mostrado na página dele no OpenRouter. Não copiamos os preços aqui porque eles mudam. O Oriveo mostra um custo estimado em cada resposta; as páginas de atividade e de cobrança do OpenRouter são o registro final.

Como usar o OpenRouter no iPhone, no Android ou na web?

Como não existe app oficial do OpenRouter para celular, você escolhe um app cliente. No Oriveo, o OpenRouter é um dos 15 provedores integrados e aparece em Agregadores, então você não precisa digitar nenhum endereço.

  • Abra Provedores: é uma aba no iPhone e no Android, ou um item da barra lateral na web.
  • Toque no botão + (Adicionar provedor) e escolha OpenRouter. O filtro Agregadores deixa a lista menor.
  • Cole a sua chave em "Conectar OpenRouter" e toque em Continuar.
  • Espere a mensagem "Validando conexão e sincronizando modelos...". O Oriveo carrega a lista de modelos do OpenRouter.
  • Escolha um modelo e comece a conversar. Sem créditos, escolha um cujo ID termine em ":free".
Tela inicial do Oriveo com a caixa de mensagem, o modelo selecionado logo abaixo e as conversas do dia, cada uma com o seu custo
Depois de conectar uma chave, escolha o modelo embaixo da caixa de mensagem. Cada conversa da lista mostra o custo estimado.

Para onde vai a minha API key do OpenRouter?

No iPhone e no Android, as solicitações vão direto do seu aparelho ao provedor, e a chave fica no armazenamento seguro do celular (Keychain no iPhone, Keystore no Android). No app web, as solicitações passam por um repasse em tempo real no servidor do Oriveo: a chave é usada só naquela solicitação e não é salva como registro da conta, e as conversas BYOK não são guardadas como logs de chat. A sincronização na nuvem não envia as chaves. Para usar o OpenRouter em um segundo aparelho, cole a chave lá também, ou crie uma chave separada para ele.

Você paga o OpenRouter diretamente, pelos preços dele. O Oriveo não cobra nenhum acréscimo.

Por que a minha API key do OpenRouter não funciona?

A página de erros do OpenRouter (openrouter.ai/docs/api-reference/errors) explica o que cada código significa. Os mais comuns, em 18 de novembro de 2026:

  • No Oriveo, o erro 402 aparece como "Cota do provedor esgotada", e o 429 como "Limite de taxa" na web ou "Limite de taxa do provedor" no iPhone e no Android.
  • Um modelo sumiu da sua lista: sincronize a lista de modelos de novo e confira se o OpenRouter ainda oferece esse modelo.
Por que a minha API key do OpenRouter não funciona?
ErroO que significaO que fazer
401 Invalid credentialsA chave está errada, desativada ou foi apagadaCopie a chave inteira de novo, ou crie uma nova
401 "this is not an OpenRouter API key"Você colou a chave de outro provedorUse uma chave de openrouter.ai/keys; ela começa com sk-or-v1-
402 insufficient creditsA sua conta ou esta chave ficou sem créditosAdicione créditos ou aumente o limite da chave; esperar não resolve
403 ForbiddenBloqueado por permissões, moderação, uma regra de proteção (guardrail) ou um limite de orçamentoConfira as configurações e os limites da chave, ou mude a sua mensagem
429 rate limitedSolicitações demais, no OpenRouter ou no provedor do modeloEspere e tente de novo; com modelos grátis, confira os limites acima
502 ou 503O modelo ou os provedores dele estão indisponíveis agoraTente mais tarde ou escolha outro modelo

OpenRouter ou uma chave de cada provedor?

O OpenRouter é prático quando você quer muitos modelos com uma chave e um saldo só. Uma chave direto do provedor, como a OpenAI ou a Anthropic, serve melhor quando você quer a conta e a cobrança do próprio provedor. O Oriveo aceita os dois, então dá para manter o OpenRouter ao lado das chaves diretas e trocar de modelo, um depois do outro, na mesma conversa.

Dúvidas comuns sobre o app

O OpenRouter é grátis?
Em parte. A chave é grátis, e os modelos cujo ID termina em ":free" não custam nada dentro dos limites diários: em 18 de novembro de 2026, 50 solicitações por dia, ou 1.000 depois que você compra pelo menos 10 créditos. Os outros modelos precisam de créditos pré-pagos.
Onde pego a minha API key do OpenRouter?
Em openrouter.ai/keys, depois de entrar na sua conta. Crie uma chave, dê um nome e copie a chave inteira; ela começa com "sk-or-v1-".
O OpenRouter tem app para iPhone ou Android?
O OpenRouter não publica um app de chat próprio para celular. Use um app de chat que aceite uma chave do OpenRouter: no Oriveo, abra Provedores, toque em +, escolha OpenRouter, cole a chave e toque em Continuar.
O que significa o erro 402 do OpenRouter?
A sua conta ou a chave que você está usando não tem créditos suficientes. Adicione créditos no OpenRouter, ou aumente o limite da chave se você definiu um, e tente de novo. O erro não some sozinho.
Por que a minha API key do OpenRouter não funciona?
Veja o número do erro. 401 quer dizer que a chave está errada ou não é do OpenRouter; 402, que não há créditos; 429, que houve solicitações demais ou que o limite dos modelos grátis acabou. O nosso guia de erros de API key explica cada código.
Como é uma API key do OpenRouter?
Ela começa com "sk-or-v1-", seguida de 64 letras e números, com 73 caracteres no total. Se a sua for mais curta, uma parte não foi copiada.

Leituras relacionadas

Do nosso blog

Use a sua chave do OpenRouter no celular

Abra o app web ou baixe o Oriveo para iPhone ou Android, cole a sua chave do OpenRouter e alterne entre modelos com um custo estimado em cada resposta.

Ainda não tem uma chave de API? Comece com o Oriveo Free.