> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Proveedores de IA

> Guarda una sola vez las claves propias de tu organización para OpenAI, Anthropic, OpenRouter, Vercel AI Gateway, TypeSafe y Deepgram, y ejecuta monitores con ellas.

**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](https://docs.zelto.ai/es/docs/monitors.md) 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](https://docs.zelto.ai/es/docs/settings.md)).

## Proveedores compatibles

| Proveedor | Para qué sirve la clave |
| - | - |
| **OpenAI** | Modelos GPT a través de tu cuenta de OpenAI. |
| **Anthropic** | Modelos Claude a través de tu cuenta de Anthropic. |
| **OpenRouter** | Cientos de modelos con una sola clave de OpenRouter. |
| **Vercel AI Gateway** | Modelos de muchos proveedores con tu clave del gateway. |
| **TypeSafe** | Decisiones tipadas de sí/no, categoría y puntuación. Consulta [Modelos TypeSafe con tu propia clave](https://docs.zelto.ai/es/docs/monitors.md#modelos-typesafe-con-tu-propia-clave). |
| **Deepgram** | Voz a texto. Se guarda ya para los próximos Benchmarks; los monitores no la usan. |

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](https://docs.zelto.ai/es/docs/settings.md#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](https://docs.zelto.ai/es/docs/monitors.md#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](https://docs.zelto.ai/es/docs/plans.md).
* 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](https://docs.zelto.ai/es/docs/settings.md#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](https://docs.zelto.ai/es/api-reference/agents/list-agents), 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](https://docs.zelto.ai/es/docs/mcp.md#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](https://docs.zelto.ai/es/docs/monitors.md): los jueces que se ejecutan con estas claves.
* [Configuración](https://docs.zelto.ai/es/docs/settings.md): uso, facturación y registro de auditoría.
* [MCP](https://docs.zelto.ai/es/docs/mcp.md): gestiona las claves desde un cliente de IA.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.