# Router IA

Chaves OpenRouter em nome da empresa, com consumo cobrado do saldo da ArduMaker e pausa automática por saldo negativo.

Fonte: https://ardumaker.com/pt/docs/router-ia/

- Categoria: Inteligência artificial e agentes
- Estado: Disponível
- Requisitos: Uma empresa com um meio de pagamento ativo; Saldo positivo suficiente (ver [Chaves de IA](https://ardumaker.com/pt/docs/claves-ia)); Para criar, revogar ou reativar chaves: ser admin da empresa
- Ferramentas MCP (Só leem): `listar_claves_router_ia`, `ver_clave_router_ia`
- Ferramentas MCP (Escrevem ou modificam): `crear_clave_router_ia`, `revocar_clave_router_ia`, `reactivar_clave_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](https://ardumaker.com/pt/docs/claves-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.

```bash
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

**Do pedido ao saldo**

```text
A sua app (token do Router IA)
  ↓
OpenRouter (modelo escolhido; aplica o teto da chave)
  ↓
Sincronização da ArduMaker (lê o uso da chave)
  ↓
Saldo da empresa (consumo em EUR com comissão; pausa se passar o negativo autorizado)
```

## 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

| Sintoma | Causa | O que fazer |
| --- | --- | --- |
| O OpenRouter rejeita a chave | A chave está pausada (saldo, verificação ou revogada) ou atingiu o teto | Carregar saldo, completar a verificação ou esperar o reinício do teto |
| As reuniões não são transcritas | A empresa não tem uma chave ativa | Criar ou reativar uma |
| Erro ao criar no OpenRouter | O OpenRouter não respondeu ou rejeitou o pedido | Tentar mais tarde |

Os erros ao criar, revogar e reativar estão em [Chaves de IA](https://ardumaker.com/pt/docs/claves-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](https://ardumaker.com/pt/mcp/docs) e exemplos em [/mcp/ia](https://ardumaker.com/pt/mcp/ia).

## Funcionalidades relacionadas

- [Chaves de IA](https://ardumaker.com/pt/docs/claves-ia/)
- [Search API](https://ardumaker.com/pt/docs/search-api/)
- [Transcrição](https://ardumaker.com/pt/docs/transcripcion/)
- [Saldo por empresa](https://ardumaker.com/pt/docs/saldo-por-empresa/)
- [Consumo de serviços](https://ardumaker.com/pt/docs/consumo-de-servicios/)