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

# AI Gateway

> Gestiona el acceso a la API de IA con claves restringidas, créditos de pago y registros recientes.

## Resumen

AI Gateway ofrece acceso a modelos mediante API y gestión de claves.
El panel reúne resumen, modelos, claves, uso, facturación y documentación.
Las llamadas utilizan créditos de pago.

El saldo total de la cuenta no debe confundirse con el saldo válido para Gateway.
Los créditos de otros orígenes no sustituyen automáticamente a los créditos de pago.

## Para quién es

* Quienes integran modelos de IA en una aplicación.
* Quienes necesitan separar el acceso por clave.
* Quienes quieren limitar los modelos y orígenes permitidos.
* Quienes necesitan inspeccionar llamadas recientes y créditos cobrados.

## Cómo abrir

Usa **Panel › AI Gateway**, con `?tab=ai-gateway`.
Las subsecciones usan entradas como `?tab=ai-gateway:overview`.
El panel conserva la sección seleccionada durante la navegación interna.

> [!NOTE]
>
> La pantalla controla el acceso para Premium y Business.
> La disponibilidad del panel no elimina la necesidad de créditos de pago para las llamadas.

## Pantallas y funciones

![Captura de pantalla: AI Gateway](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/doglytdc/ai-gateway.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=93b86d1ca22bb7e39065dc5927a2b497)

AI Gateway en DoglyTdc

### Resumen

El resumen presenta indicadores de acceso y consumo.
Comprueba el saldo de créditos de pago antes de iniciar una integración.
No uses solo el saldo total para prever la capacidad.

### Modelos

El catálogo muestra los modelos disponibles en Gateway.
Usa el identificador que aparece en la documentación de la propia interfaz.
Una clave puede restringir los modelos que tu integración puede solicitar.

### Claves

Cada clave tiene nombre, estado y alcance.
Al crearla puedes configurar modelos, orígenes, un límite mensual y solicitudes por minuto.
La credencial completa se muestra una sola vez.

**1. Define el uso**

Crea una clave para la integración deseada.
Elige un nombre que permita reconocer su finalidad.

**2. Restringe el acceso**

Selecciona los modelos y orígenes permitidos.
Configura límites adecuados al uso previsto.

**3. Guarda la credencial**

Copia la credencial al crearla.
Guárdala de forma segura, fuera del contenido público.

**4. Prueba y supervisa**

Haz una llamada con el modelo permitido.
Comprueba el estado, la latencia y el cobro en la sección de uso.

### Restricciones por clave

La lista de modelos limita el alcance de esa clave.
La lista de orígenes controla los dominios autorizados.
La interfaz también permite configuraciones amplias, como todos los modelos o cualquier origen.

El límite mensual se expresa en créditos.
El límite de frecuencia se expresa en solicitudes por minuto.
No configurar un límite no significa tener saldo infinito.

### Estado de la clave

Una clave se puede desactivar y volver a activar.
Revocar es distinto de simplemente desactivar.
Las llamadas identifican con errores diferentes las claves revocadas y desactivadas.

**1. Identifica la clave**

Comprueba el nombre, el prefijo y la información visible en el panel.
Evita modificar otra integración por error.

**2. Elige la acción**

Desactívala para interrumpir su uso.
Revócala cuando necesites invalidar la credencial.

**3. Comprueba la integración**

Verifica que la aplicación haya empezado a usar una clave válida.
No sigas repitiendo llamadas con una clave revocada.

### Uso

La pantalla carga hasta 100 registros recientes.
Los nuevos registros también mantienen la lista limitada a los 100 más recientes.
La lista no es un archivo completo de todo el historial.

Los registros incluyen modelo, origen, estado, latencia y créditos cobrados.
Usa estos datos para investigar fallos y consumo reciente.
No concluyas que no hubo uso anterior solo porque no aparezca en esta lista.

### Facturación y documentación

La sección de facturación diferencia los créditos de pago de otros créditos.
La documentación incluye ejemplos de integración y códigos de error.
Consulta los ejemplos que muestra la interfaz para el entorno en uso.

## Créditos y límites

* Gateway utiliza créditos de pago.
* El saldo de otros créditos aparece por separado.
* Cada clave puede tener un límite mensual de créditos.
* Cada clave puede tener un límite de llamadas por minuto.
* Las restricciones de modelos y orígenes siguen vigentes incluso con saldo.
* La lista de uso muestra hasta 100 registros recientes.

## Permisos

El panel comprueba el acceso al recurso según el plan.
Las llamadas necesitan una clave válida, activa y no revocada.
La clave también debe permitir el modelo y el origen solicitados.
No publiques la credencial en ejemplos ni repositorios abiertos.

## Errores comunes

| Mensaje | Qué significa | Qué hacer |
| - | - | - |
| 401 invalid\_api\_key | La clave no es válida. | Comprueba la credencial configurada. |
| 401 key\_revoked | La clave se revocó. | Usa una nueva clave válida. |
| 403 key\_disabled | La clave está desactivada. | Vuelve a activarla en el panel, si corresponde. |
| 403 origin\_not\_allowed | El origen no está autorizado. | Comprueba los dominios permitidos. |
| 403 model\_not\_allowed | El modelo está fuera del alcance. | Elige un modelo permitido. |
| 402 insufficient\_paid\_credits | Faltan créditos de pago. | Comprueba el saldo de pago en facturación. |

## Preguntas frecuentes

> [accordion] ¿Todos los créditos de la cuenta sirven para Gateway?
>
> No. Gateway utiliza créditos de pago y los distingue de los demás.

> [accordion] ¿Puedo recuperar después la credencial completa?
>
> La pantalla indica que solo se muestra una vez. Guárdala de forma segura al crearla.

> [accordion] ¿La sección de uso contiene todo el historial?
>
> No. Muestra hasta 100 registros recientes.

## Relacionado

> [card] [Créditos y planes](https://docs.doglytdc.dev/es/doglytdc/getting-started/credits-and-plans.md)

> [card] [Scripts](https://docs.doglytdc.dev/es/scripts/introduction.md)


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