PT ▾
Obter chave de API

Como funciona o preço do OpenRouter? Camadas explicadas

Como funciona o preço do OpenRouter? Em resumo, cada modelo tem seu próprio preço por milhão de tokens de entrada e por milhão de tokens de saída, definido pelo provedor que o serve, e você paga com crédito pré-pago na conta do roteador. Este artigo lista as camadas a verificar e as compara com uma taxa fixa.

Atualizado

Pilha de camadas de vidro com fluxos de moedas se fundindo em um único fluxo que alimenta um medidor, mostrando o preço em camadas do roteador
Muitos cabos irradiando de um hub em contraste com um link direto para um único cubo de modelo brilhante

Pontos principais

  • As contas do roteador combinam o preço por token do modelo, diferenças de provedor e quaisquer taxas do lado do roteador; leia a página de preços atual para valores exatos.
  • Tokens de entrada e saída são precificados separadamente em todos os lugares, e a saída geralmente custa mais.
  • Um modelo de preço plano tem uma única taxa de entrada e uma única taxa de saída: $0.15 e $0.50 por 1M de tokens aqui.
  • Estime o custo com um script curto que lê o campo de uso de cada resposta.

As camadas de preço de um roteador

Um roteador revende acesso a modelos de muitos provedores. Isso gera uma pilha de componentes de preço. Descrevo a estrutura aqui e deixo os números exatos para as próprias páginas do roteador, pois elas mudam e eu estaria adivinhando.

  1. Preço do token do modelo. Cada modelo lista uma taxa por 1M de tokens de entrada (prompt) e por 1M de tokens de saída (completamento). Modelos maiores custam mais que os menores, muitas vezes por uma margem ampla.
  2. Escolha do provedor. O mesmo modelo pode ser hospedado por vários provedores a preços, velocidades e limites diferentes. Um roteador pode escolher um para você por preço, velocidade ou disponibilidade, então sua taxa efetiva pode variar.
  3. Taxas do lado do roteador. Verifique se o roteador adiciona uma taxa ao comprar crédito, um acréscimo no uso ou valores mínimos de compra.
  4. Variantes especiais de modelo. Alguns catálogos listam variantes gratuitas ou com desconto com limites mais rígidos. Leia os limites antes de construir sobre eles.
  5. Recursos extras. Qualquer coisa além de texto puro, como entrada de imagem ou uso de ferramentas, pode ser precificada de forma diferente pelo modelo.

Nada disso é ruim. É o custo de ter cem modelos atrás de uma única chave. O problema é apenas que uma fatura é mais difícil de prever. Para uma comparação mais ampla, consulte Alternativas à API OpenRouter comparadas.

Tokens, entrada versus saída

Qualquer que seja o provedor, a cobrança conta tokens. Um token é um trecho de texto, cerca de quatro caracteres em inglês. Um prompt de 1.000 palavras tem aproximadamente 1.300 tokens. Os tokens de entrada cobrem tudo que você envia: prompt do sistema, histórico de chat, documentos e definições de ferramentas. Os tokens de saída são o que o modelo escreve de volta.

A saída geralmente custa mais por token do que a entrada, então uma resposta verbosa custa mais do que um prompt longo do mesmo tamanho. Aplicativos de chat também reenviam o histórico a cada turno, o que significa que o custo de entrada cresce durante uma conversa mesmo quando cada resposta é curta.

O tokenizador exato varia conforme o modelo, então o mesmo texto pode ser contado como quantidades diferentes em modelos diferentes. Ao comparar dois modelos pelo preço, compare o custo para o seu próprio conjunto de prompts, não as tabelas de tarifas.

Exemplo prático: o mesmo mês, dois modelos

Suponha uma carga de trabalho de 30M de tokens de entrada e 6M de tokens de saída por mês. O Modelo A em um roteador tem, para este exemplo fictício, um preço de $1 e $4 por milhão de tokens de entrada e saída. Essas figuras são fictícias para o exemplo. A conta é 30 x $1 + 6 x $4 = $30 + $24 = $54, mais quaisquer taxas aplicáveis.

Em um endpoint com taxa fixa de $0.15 por 1M de entrada e $0.50 por 1M de saída, o mesmo volume custa 30 x $0.15 + 6 x $0.50 = $4,50 + $3,00 = $7,50. Isso não é um argumento de que mais barato sempre significa melhor. Os dois modelos se comportam de forma diferente, e o maior pode ser o que sua tarefa precisa. Isso mostra por que você deve precificar seu volume real em vez de ler as tarifas divulgadas.

Outro ponto prático: muitos routers mostram um preço para uma solicitação típica ao lado do modelo. Multiplique-o pelas suas solicitações diárias e por 30 para validar um plano antes de se comprometer.

A alternativa de preço fixo

O endpoint deste site, https://api.openrouteralternativeapi.com/v1, tem um modelo, uncensored, e uma lista de preços. Entrada é $0,15 por 1M de tokens e saída é $0,50 por 1M. Você paga com crédito pré-pago sem assinatura, requisições falhas ou recusadas não são cobradas, e o crédito nunca expira. Não há camada de roteador: o modelo é executado por um provedor independente e não é um produto oficial de nenhum grande laboratório.

Isso torna o planejamento de custos um cálculo de uma linha. Uma chamada com 2.000 tokens de entrada e 500 tokens de saída custa 2.000 x $0.15 / 1M + 500 x $0.50 / 1M = $0,0003 + $0,00025 = $0,00055. Mil chamadas assim custam $0,55. Se você precisa de muitos modelos diferentes, um router é a melhor opção; se precisa de apenas um, a precificação fixa é mais fácil de calcular. Consulte a página de preços para bônus de recarga.

Meça o custo real com um pequeno script

Não confie em estimativas por muito tempo. A resposta inclui um bloco usage com contagens de tokens de prompt e completamento, e esta API também retorna um cabeçalho X-Balance-USD com seu crédito restante. Use qualquer um para registrar o custo por chamada:

from openai import OpenAI

client = OpenAI(base_url="https://api.openrouteralternativeapi.com/v1", api_key="YOUR_KEY")

PRICE_IN, PRICE_OUT = 0.15, 0.50   # dollars per 1M tokens

def run(prompt):
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "user", "content": prompt}],
    )
    u = r.usage
    cost = (u.prompt_tokens * PRICE_IN + u.completion_tokens * PRICE_OUT) / 1e6
    return r.choices[0].message.content, cost

text, cost = run("List three risks of changing a database schema live.")
print(f"cost this call: ${cost:.6f}")

Execute-o em cem prompts reais e você terá um custo por tarefa que inclui os comprimentos reais dos seus prompts. Faça o mesmo em um router com um modelo que você está considerando, usando os números no painel deles, e compare os dois totais. O artigo sobre o endpoint compatível com OpenAI estilo OpenRouter explica como o lado do cliente é idêntico.

Orçamento e recargas

Defina um orçamento antes de começar. O crédito pré-pago ajuda aqui, pois você não pode gastar mais do que carregou. Nesta API, recargas podem ser qualquer valor inteiro de $20 a $500, com +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Uma recarga de $100 fornece $110 de crédito. No valor de $0.00055 por chamada acima, isso equivale a 200.000 chamadas.

Você pode pagar com cripto (USDT na TRC20, USDC na Base). Os limites de requisições protegem seu orçamento: uma chave completa permite até 8 requisições simultâneas e 300 por minuto, uma chave de teste permite 2 e 60, com HTTP 429 após isso. Experimentar não custa nada: solicite o crédito de teste de $0.50 na página de chave de API, sem cartão, válido por 7 dias. Detalhes do endpoint estão na documentação.

Perguntas e respostas

O OpenRouter cobra por token?

Sim, cada modelo lista um preço por milhão de tokens de entrada e por milhão de tokens de saída. Verifique a página de preços atual para ver as taxas exatas e quaisquer taxas adicionais.

Por que o mesmo modelo pode custar valores diferentes em um roteador?

Diferentes provedores hospedam o mesmo modelo a preços diferentes, e o roteador pode escolher entre eles. Verifique como suas requisições são roteadas.

Como é o preço desta API?

Um preço fixo de $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, pago com crédito pré-pago sem assinatura.

Sou cobrado por requisições falhas aqui?

Não. Requisições falhas ou recusadas não são cobradas.

Sua chave está a um clique de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.