Saltar al contenido principal
Configuración → Proveedores de IA guarda las claves propias de tu organización para proveedores de IA (trae tu propia clave). Añades una clave una sola vez y cualquier monitor puede ejecutarse con ella en lugar de los modelos integrados de Zelto. La página está en /org/<slug>/settings/ai-providers y solo pueden abrirla propietarios y administradores (consulta los roles).

​
Proveedores compatibles

Puedes guardar varias claves del mismo proveedor, por ejemplo una por equipo o por entorno. Cada una necesita su propio nombre.

​
Añadir una clave

  1. Abre Configuración → Proveedores de IA y elige Agregar clave en el proveedor.
  2. Pega la clave desde el panel de tu proveedor. Si quieres, ponle un nombre; por defecto es el nombre del proveedor.
  3. Elige Guardar clave.
Zelto comprueba la clave con una llamada sin costo al proveedor (por ejemplo, listar sus modelos) antes de guardarla. Una clave que el proveedor rechaza no se guarda, y si no se puede contactar al proveedor, no se guarda nada y puedes volver a intentarlo. La clave se guarda cifrada. Desde entonces solo se muestran sus últimos cuatro caracteres, en la aplicación, la API y MCP.

​
Probar, rotar, renombrar y eliminar

  • Probar vuelve a comprobar una clave guardada y muestra Funciona o Falló la comprobación. Una clave que falla se reporta, no se elimina.
  • Rotar reemplaza el secreto. La nueva clave se comprueba primero, así que un error de tipeo deja la clave actual en su lugar. Todos los monitores que usan la clave pasan al nuevo secreto a la vez, porque los monitores hacen referencia a la clave en lugar de copiarla. Deja vacío el campo de la clave para solo renombrarla.
  • Eliminar borra la clave. Se rechaza mientras algún monitor siga ejecutándose con ella, y se muestra la lista de esos monitores: cámbialos antes a otra clave o al modelo integrado.
Añadir, rotar, renombrar y eliminar una clave escriben cada uno una entrada en el registro de auditoría (ai_key.created, ai_key.rotated, ai_key.renamed, ai_key.deleted) con el proveedor, el nombre y los últimos cuatro caracteres. El secreto nunca se registra.

​
Usar una clave en un monitor

En la configuración del modelo del editor de monitores, elige el proveedor, luego una de las claves de la organización para ese proveedor, y escribe el id de modelo propio del proveedor (por ejemplo gpt-5, claude-sonnet-4-5 o anthropic/claude-sonnet-4.5 en OpenRouter y el gateway). Si todavía no hay una clave para ese proveedor, el editor enlaza a esta página. Elegir qué clave usa un monitor es solo para propietarios o administradores. El paso Pruébalo usa la misma clave, así que puedes probar un monitor con ella antes de guardarlo. Consulta Pruébalo antes de activarlo. Desde la API, PUT /v1/monitors/{id}/model con { "aiKeyId": "…", "model": "gpt-5" } pone un monitor guardado en una clave, y { "provider": "bedrock" } (con un modelTier opcional) lo devuelve al modelo integrado. Por MCP, el mismo cambio es set_monitor_model, y test_monitor con aiKeyId y model lo prueba antes. Cambiar el proveedor o el modelo abre una nueva versión del monitor y reinicia su alerta; cambiar a otra clave del mismo proveedor no.

​
Facturación

  • Tu proveedor te factura directamente los tokens usados con tu clave.
  • Ese uso no cuenta para las ejecuciones ni los tokens de monitores de tu plan. Consulta Planes, límites y retención.
  • Zelto cobra una tarifa de plataforma por clave propia por ejecutar el pipeline, el almacenamiento y los resultados en torno a esas llamadas: un porcentaje del costo estimado a precio de lista de ese uso. El valor por defecto es 5%; tu acuerdo puede fijar otra tarifa, incluido 0%. La tarifa aparece en Configuración → Uso y como una línea de tu factura mensual de uso.
El precio de lista estimado es una estimación de Zelto a partir de los precios publicados de los modelos (los catálogos de modelos de OpenRouter y Vercel AI Gateway, actualizados cada pocas horas, más los precios publicados de OpenAI, Anthropic y TypeSafe), no la factura de tu proveedor. Un modelo sin precio publicado conocido por Zelto (incluidos los modelos que un catálogo lista como gratuitos y los enrutadores de precio variable como openrouter/auto) no puede llevar un porcentaje, así que cada llamada paga una pequeña tarifa fija: $0.00001 con la tarifa predeterminada del 5% ($0.01 cada 1.000 llamadas, cerca del 5% de una llamada típica a Jev de TypeSafe), escalada con tu tarifa.

​
Modo PHI

Las organizaciones en modo PHI no pueden añadir ni rotar claves: el contenido de las llamadas no puede enviarse a un proveedor externo con tu propia clave. Si una organización con claves activa el modo PHI, esas claves dejan de usarse de inmediato y solo pueden eliminarse. Lo mismo vale para una clave guardada en un monitor individual antes de que existieran las claves de organización: los monitores de una organización en modo PHI solo usan los modelos integrados de Zelto.

​
API y MCP

Todo lo de esta página también está disponible por programación, con las mismas comprobaciones y errores. Ambos requieren una clave de propietario o administrador.
  • REST: GET/POST /v1/ai-keys, GET/PATCH/DELETE /v1/ai-keys/{id} y POST /v1/ai-keys/{id}/test, además de PUT /v1/monitors/{id}/model. Consulta la referencia de API, en Proveedores de IA.
  • MCP: list_ai_keys, create_ai_key, update_ai_key, test_ai_key, delete_ai_key, set_monitor_model, y las entradas aiKeyId y model de test_monitor. Consulta Claves de proveedores de IA en la página de MCP.
Si una persona puede pegar la clave, usa la página de Configuración: por la API o MCP, el secreto pasa por el script o el agente que lo envía.

​
Relacionado

  • Monitores: los jueces que se ejecutan con estas claves.
  • Configuración: uso, facturación y registro de auditoría.
  • MCP: gestiona las claves desde un cliente de IA.