Créditos IA, Voz y Llaves BYOK

Matias Impulso te otorga control financiero absoluto sobre el consumo de Inteligencia Artificial mediante dos esquemas complementarios que puedes combinar por empresa o incluso por agente individual.

1. Sistema de Créditos IA (Sin Vencimiento)

Saldo incluido en tu plan: los planes de suscripción otorgan una asignación mensual renovable de créditos IA.
Paquetes adicionales que NO vencen: las recargas adquiridas (1K, 5K, 15K, 50K créditos) se acumulan en un bolsillo perpetuo que solo se consume cuando agotas los créditos incluidos del ciclo mensual.
Trazabilidad total: consulta en todo momento el saldo consolidado (GET /ai-credits/balance) y el libro mayor de movimientos por turno, modelo y agente (GET /ai-credits/transactions).

2. Notas de Voz y Procesamiento Multimodal

Tus clientes en Colombia y Latinoamérica se comunican frecuentemente mediante notas de voz y capturas de pantalla (comprobantes de pago, fotos de productos o fórmulas):

Transcripción automática de audio entrante: convierte notas de voz de WhatsApp/Instagram en texto procesable tanto para el Agente de IA como para lectura rápida del asesor humano (POST /media/transcribe).
Respuestas en voz neuronal: permite responder con notas de voz naturales cuando el cliente se comunica por audio o según la configuración del agente (POST /media/generate-voice).
Visión artificial: interpreta imágenes recibidas en la conversación con contexto estructurado (POST /media/analyze-image).

3. BYOK (Bring Your Own Key)

Si tu organización ya cuenta con contratos directos en Anthropic (Claude) u OpenAI, puedes registrar tus propias llaves API:

A Nivel de Empresa
Por Agente Específico

Aplica tu llave propia como proveedor predeterminado para todos los agentes de tu organización:

PUT /ai-credits/byok/providers/anthropic
Authorization: Bearer <YOUR_JWT_ACCESS_TOKEN>
Content-Type: application/json

{
  "apiKey": "<YOUR_PROVIDER_API_KEY>"
}

Asigna una llave dedicada a un agente puntual (útil para separar centros de costos por departamento):

PUT /ai-credits/byok/agents/12
Authorization: Bearer <YOUR_JWT_ACCESS_TOKEN>
Content-Type: application/json

{
  "providerType": "anthropic",
  "apiKey": "<YOUR_AGENT_PROVIDER_API_KEY>"
}