Router IA

Claves de OpenRouter a nombre de la empresa, con consumo cobrado del saldo de ArduMaker y pausa automática por saldo negativo.

  • Categoría: Inteligencia artificial y agentes
  • Estado: Disponible
  • Requisitos: Una empresa con un medio de pago activo; Saldo a favor suficiente (ver Claves de IA); Para crear, revocar o reactivar claves: ser admin de la empresa
  • Herramientas MCP (Solo leen): listar_claves_router_ia, ver_clave_router_ia
  • Herramientas MCP (Escriben o modifican): crear_clave_router_ia, revocar_clave_router_ia, reactivar_clave_router_ia

Markdown

¿Qué permite hacer?

  • Usar los modelos disponibles en OpenRouter con una clave a nombre de la empresa, sin cuenta propia en OpenRouter.
  • Pagar el consumo desde el saldo de ArduMaker, junto con el resto de los servicios.
  • Ver el gasto de cada clave: total, diario, semanal y mensual.
  • Que otras funciones de ArduMaker usen la clave de la empresa: transcripción y resumen de reuniones grabadas, y transcripción de audios de WhatsApp.

¿Cuándo conviene usarlo?

  • Una app o un bot de la empresa necesita un modelo de lenguaje y no se quiere manejar facturación aparte.
  • Para activar la transcripción de reuniones o de audios de WhatsApp: sin una clave activa, esas funciones quedan bloqueadas.

¿Cómo funciona en ArduMaker?

  1. Un admin crea una clave (ver Claves de IA). ArduMaker la crea en OpenRouter con su tope de gasto y devuelve el token una sola vez.
  2. La aplicación llama a la API de OpenRouter con ese token, como con cualquier clave de OpenRouter.
  3. ArduMaker sincroniza periódicamente el uso de cada clave con OpenRouter (y también al ver una clave).
  4. Cada aumento de uso se registra como consumo en el historial de la empresa: el monto en USD con la comisión de la empresa, convertido a EUR con la tasa configurada.
  5. Si el saldo baja del negativo autorizado para la empresa, la clave se pausa en OpenRouter. Cuando el saldo se recupera, se reactiva sola. Si alguien la reactiva por fuera mientras sigue en negativo, se vuelve a pausar.
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 de ArduMaker

  • Reuniones grabadas: se transcribe el audio y se resume con la clave de la empresa dueña de la grabación; el texto de la reunión se trata como dato, no como instrucción. Sin clave activa, la grabación se guarda y se reproduce igual, pero no se transcribe.
  • Audios de WhatsApp: se transcriben con la primera clave activa de la empresa; sin ninguna, la transcripción falla.
  • El gasto de esos usos queda en la misma cuenta y bajo los mismos topes que el resto.

¿Qué cambia realmente?

  • En OpenRouter: una clave por cada una creada, con su nombre, tope y reinicio del tope.
  • En ArduMaker: la clave asociada a un servicio de la empresa y movimientos de consumo en su historial a medida que se usa.
  • Si la empresa queda pendiente de verificación de identidad, sus claves activas se pausan en OpenRouter hasta que se verifique.

Esquema

  1. Tu app: token de Router IA
  2. OpenRouter: modelo elegido; aplica el tope de la clave
  3. Sincronización de ArduMaker: lee el uso de la clave
  4. Saldo de la empresa: consumo en EUR con comisión; pausa si pasa el negativo autorizado
Del pedido al saldo

Resultado esperado

  • listar_claves_router_ia muestra las claves de la empresa, nunca el token.
  • ver_clave_router_ia sincroniza en el momento y devuelve uso, tope y restante; los gastos detallados solo los ve un admin.
  • El consumo aparece en el historial de pagos y en el uso del período de la empresa.

Errores y resolución

SíntomaCausaQué hacer
OpenRouter rechaza la claveLa clave está pausada (saldo, verificación o revocada) o llegó a su topeRecargar saldo, completar la verificación o esperar el reinicio del tope
Las reuniones no se transcribenLa empresa no tiene una clave activaCrear o reactivar una
Error al crear en OpenRouterOpenRouter no respondió o rechazó el pedidoReintentar más tarde

Los errores al crear, revocar y reactivar están en Claves de IA.

Relación con MCP

Sí, en los perfiles /mcp e /mcp/infra: listar_claves_router_ia y ver_clave_router_ia (lectura, nunca devuelven el token), crear_clave_router_ia (escritura, solo admin; único momento en que se ve el token), revocar_clave_router_ia (destructiva pero reversible) y reactivar_clave_router_ia. Referencia en /mcp/docs y ejemplos en /mcp/ia.

Funciones relacionadas