# Agregador API (nano-gpt compatible)

> Proxy agregado sobre https://nano-gpt.com/api. Compatible 100% con clientes OpenAI y Anthropic.
> Base OpenAI: {PUBLIC_BASE_URL}/api/v1  ·  Base Anthropic: {PUBLIC_BASE_URL}/api
> Autenticación de inferencia: `Authorization: Bearer sk-agg-...` (o `x-api-key: sk-agg-...`).
> Cobro: prepago pay-as-you-go; el consumo se descuenta de tu saldo. Recarga mínima 5 USD.

## Documentación
- [Agent quickstart](/docs/agent-quickstart.md): conectar un agente en 2 minutos
- [Compatibilidad](/docs/compatibility.md): contrato drop-in y migración a nano-gpt directo
- [Facturación](/docs/billing.md): cómo se mide y cobra el consumo
- [Cuenta](/docs/account.md): perfil, contraseña y baja de la propia cuenta
- [Admin](/docs/admin.md): panel administrativo y acciones auditadas

## Descubrimiento para agentes
- OpenAPI: /openapi.json
- Swagger UI: /swagger/
- Salud: /healthz
- Modelos (público del cliente): /api/portal/models (requiere JWT del portal)
- Catálogo upstream passthrough: /api/v1/models?detailed=true (requiere key sk-agg-)
- Saldo del cliente (compat): POST /api/check-balance