Router IA

O que permite fazer?

• Usar os modelos disponíveis no OpenRouter com uma chave em nome da empresa, sem conta própria no OpenRouter.
• Pagar o consumo a partir do saldo da ArduMaker, junto com o resto dos serviços.
• Ver o gasto de cada chave: total, diário, semanal e mensal.
• Que outras funções da ArduMaker usem a chave da empresa: transcrição e resumo de reuniões gravadas, e transcrição de áudios de WhatsApp.

Quando convém usar?

• Uma app ou um bot da empresa precisa de um modelo de linguagem e não se quer gerenciar faturamento à parte.
• Para ativar a transcrição de reuniões ou de áudios de WhatsApp: sem uma chave ativa, essas funções ficam bloqueadas.

Como funciona na ArduMaker?

1. Um admin cria uma chave (ver Chaves de IA). A ArduMaker cria-a no OpenRouter com o seu teto de gasto e devolve o token uma única vez.
2. A aplicação chama a API do OpenRouter com esse token, como com qualquer chave OpenRouter.
3. A ArduMaker sincroniza periodicamente o uso de cada chave com o OpenRouter (e também ao ver uma chave).
4. Cada aumento de uso fica registrado como consumo no histórico da empresa: o montante em USD com a comissão da empresa, convertido para EUR com a taxa configurada.
5. Se o saldo descer abaixo do negativo autorizado para a empresa, a chave é pausada no OpenRouter. Quando o saldo recupera, é reativada sozinha. Se alguém a reativar por fora enquanto continua em negativo, volta a ser pausada.

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $ROUTER_IA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/gemini-2.5-flash-lite", "messages": [{"role": "user", "content": "Hola"}]}'

Usos dentro da ArduMaker

• Reuniões gravadas: transcreve-se o áudio e resume-se com a chave da empresa dona da gravação; o texto da reunião é tratado como dado, não como instrução. Sem chave ativa, a gravação é guardada e reproduzida na mesma, mas não é transcrita.
• Áudios de WhatsApp: são transcritos com a primeira chave ativa da empresa; sem nenhuma, a transcrição falha.
• O gasto desses usos fica na mesma conta e sob os mesmos tetos que o resto.

O que muda realmente?

• No OpenRouter: uma chave por cada uma criada, com o seu nome, teto e reinício do teto.
• Na ArduMaker: a chave associada a um serviço da empresa e movimentos de consumo no seu histórico sob medida que é usada.
• Se a empresa ficar pendente de verificação de identidade, as suas chaves ativas são pausadas no OpenRouter até ser verificada.

Esquema

Resultado esperado

• listar_claves_router_ia mostra as chaves da empresa, nunca o token.
• ver_clave_router_ia sincroniza no momento e devolve uso, teto e restante; os gastos detalhados só os vê um admin.
• O consumo aparece no histórico de pagamentos e no uso do período da empresa.

Erros e resolução

Os erros ao criar, revogar e reativar estão em Chaves de IA.

Relação com MCP

Sim, nos perfis /mcp e /mcp/infra: listar_claves_router_ia e ver_clave_router_ia (leitura, nunca devolvem o token), crear_clave_router_ia (escrita, só admin; único momento em que se vê o token), revocar_clave_router_ia (destrutiva mas reversível) e reactivar_clave_router_ia. Referência em /mcp/docs e exemplos em /mcp/ia.

Funcionalidades relacionadas

• Chaves de IA
• Search API
• Transcrição
• Saldo por empresa
• Consumo de serviços