HeroMate Managed AI
Cada agente de HeroMate corre en uno de dos modos de IA. HeroMate Managed AI es la opción por defecto sin configuración: sin API key, sin cuenta de proveedor — HeroMate enruta la petición por su catálogo gestionado (con OpenRouter por detrás) y mide el consumo como AI Credits. BYOK es la alternativa, donde traes tu propia key de OpenAI / Anthropic / Gemini y le pagas al proveedor directamente.
El camino feliz no necesita credencial
Pon el proveedor del agente en HeroMate Managed, elige un modelo y listo. Sin keys que crear, sin cuentas de billing que conectar. Construir y ejecutar agentes simplemente descuenta de tu saldo de AI Credits.
Los dos modos de un vistazo
| HeroMate Managed AI | BYOK (tu propia key) | |
|---|---|---|
| Necesita API key | No | Sí — OpenAI / Anthropic / Gemini |
| Dónde se configura | provider: DYPAI Managed | Una credencial en Credentials |
| Billing | AI Credits (te cobra HeroMate) | Le pagas al proveedor directamente |
| Markup | Conversión a créditos (no es pass-through) | Ninguno — HeroMate no le mete markup a tus tokens BYOK |
| Catálogo de modelos | Limitado por plan, gestionado a nivel de org | Lo que soporte tu key |
| Esfuerzo de setup | Cero | Conseguir una key, guardar una credencial |
Cómo funciona el billing de Managed
Cuando un agente corre en modo Managed, su consumo de tokens se mide como AI Credits — la misma unidad que mueve la construcción y edición de tu app. El precio se expresa como AI Credits / 1M tokens, así que los modelos más baratos y rápidos cuestan menos créditos por petición que los más grandes.
Junto al bloque usage habitual, la respuesta de un agente Managed incluye un bloque managed_ai_billing que describe lo que costó la llamada:
{
"usage": {
"prompt_tokens": 1820,
"completion_tokens": 142,
"total_tokens": 1962
},
"managed_ai_billing": {
"model": "google/gemini-2.5-flash-lite",
"credits_charged": 0.42,
"input_tokens": 1820,
"output_tokens": 142
}
}
Es una conversión a créditos, no pass-through
El precio de Managed aplica una conversión a créditos sobre el coste de generación subyacente — no es pass-through y no es "sin markup". La promesa de "sin markup" solo aplica a BYOK, donde HeroMate nunca toca la factura de tu proveedor.
Los créditos se descuentan primero de los créditos mensuales de tu plan y luego de cualquier pack de recarga comprado. Los planes Free reciben +5 AI Credits/día; Pro recibe 100/mes (más 100 créditos de lanzamiento únicos al activar). Tus apps desplegadas siguen vivas independientemente de tu saldo de créditos — los créditos solo miden el trabajo de construir/editar con IA y la inferencia Managed. Mira AI Credits para el modelo completo.
Elegir un modelo (y qué está limitado)
En HeroMate Managed AI, qué modelos puedes elegir está limitado por tu plan. El catálogo se gestiona a nivel de organización en la página de AI Models en /{org}/ai-models, así que el owner de la org controla qué modelos gestionados están disponibles para todos los proyectos del workspace.
Pon el proveedor en HeroMate Managed
En el nodo agent, elige HeroMate Managed como proveedor. No aparece ningún campo de credencial.
Elige un modelo del catálogo gestionado
El selector solo muestra los modelos que permite tu plan. Para cambiar lo que hay disponible, un owner de la org edita la página de AI Models (/{org}/ai-models).
Ajusta la llamada
max_output_tokens (por defecto 1024) está limitado por tu plan en Managed, así que peticiones muy grandes pueden recortarse automáticamente. temperature, memory_mode y tool_ids funcionan igual que en cualquier otro modo.
Nodos solo en Managed
El nodo de Generación de imágenes es solo Managed — no tiene camino BYOK. Se cobra como AI Credits (con precio basado en el coste real de generación) y devuelve una URL de storage.
Cuándo usar BYOK en su lugar
Elige BYOK cuando quieras usar un modelo concreto que no está en tu catálogo gestionado, cuando ya tengas créditos de proveedor que gastar, o cuando prefieras mantener el billing de IA en tu propia cuenta de proveedor. Añade una key de OpenAI / Anthropic / Gemini en Credentials, pon ese proveedor en el nodo del agente y elige la credencial — HeroMate no le mete markup a esos tokens. Mira Modelos y Proveedores y Credentials.