# Introducción

> Conecta tu aplicación a proveedores de inteligencia artificial mediante un solo gateway.

URL: https://boelabs.com/docs/ai-gateway
Language: Español

AI Gateway ofrece APIs compatibles con OpenAI y Anthropic. Tu aplicación envía solicitudes con una
**virtual key** y un nombre de **public model**. El gateway selecciona un deployment del proveedor,
traduce la solicitud y registra el consumo y su costo.

Tú configuras los proveedores, las reglas de routing y los límites de acceso. Las operaciones y
los parámetros disponibles dependen de los deployments de cada public model.

## Comienza aquí [#start-here]

<Cards>
  <Card title="Realiza tu primera solicitud" href="https://boelabs.com/docs/ai-gateway/quickstart">
    Ejecuta un gateway local, conecta OpenAI y realiza una solicitud con una virtual key.
  </Card>
  <Card title="Conoce los conceptos básicos" href="https://boelabs.com/docs/ai-gateway/concepts">
    Entiende cómo se relacionan los public models, deployments y adapters.
  </Card>
</Cards>

## Conecta una aplicación existente [#connect-an-existing-application]

Si un operador ya configuró AI Gateway, solo necesitas su URL base, una virtual key y el nombre de
un public model disponible. Por ejemplo, con el SDK de OpenAI para Python:

```python title="app.py"
from openai import OpenAI

client = OpenAI(base_url="http://localhost:4000/v1", api_key="<virtual-key>")
response = client.chat.completions.create(
    model="general",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)
```

En este ejemplo, `general` es un nombre configurado en AI Gateway. Puede dirigir solicitudes a uno
o varios modelos upstream sin cambiar el código de la aplicación. Consulta la
[Referencia de la API](https://boelabs.com/docs/ai-gateway/api-overview) para conocer la autenticación, los endpoints y los errores.

## Configura y opera [#configura-and-operate]

<Cards>
  <Card title="Conecta proveedores" href="https://boelabs.com/docs/ai-gateway/providers">
    Elige un adapter y configura las credenciales, los modelos y las operaciones disponibles.
  </Card>
  <Card title="Controla el routing" href="https://boelabs.com/docs/ai-gateway/routing">
    Distribuye el tráfico, establece límites por deployment y configura políticas de fallback.
  </Card>
  <Card title="Gestiona el acceso y los costos" href="https://boelabs.com/docs/ai-gateway/virtual-keys">
    Asigna a cada aplicación sus modelos permitidos, rate limits y presupuesto.
  </Card>
  <Card title="Instala AI Gateway" href="https://boelabs.com/docs/ai-gateway/deployment">
    Elige una plataforma y prepara Postgres, Redis y los secretos.
  </Card>
  <Card title="Utiliza el dashboard" href="https://boelabs.com/docs/ai-gateway/dashboard">
    Administra el gateway e investiga solicitudes desde la interfaz para operadores.
  </Card>
  <Card title="Prepara el entorno de producción" href="https://boelabs.com/docs/ai-gateway/production-checklist">
    Comprueba la seguridad, los health checks, los backups y la observabilidad antes de publicar.
  </Card>
</Cards>

## Contribuye [#contribute]

Consulta [Arquitectura](https://boelabs.com/docs/ai-gateway/architecture) para entender el recorrido de una solicitud,
[Pruebas](https://boelabs.com/docs/ai-gateway/testing) para validar los cambios y
[Desarrollo de la documentación](https://boelabs.com/docs/ai-gateway/documentation) para trabajar en estas páginas.