Autenticación
Dónde obtener tu Base URL y cómo se autentica cada protocolo: Bearer, x-api-key, x-goog-api-key.
Cada llamada necesita dos cosas: una clave de API (que demuestra quién eres) y la Base URL (adónde va la solicitud). Ambas están disponibles en la consola.
Obtener la Base URL
Inicia sesión en la consola y abre el diálogo «Inicio rápido» en cualquier tarjeta de modelo (o desde el resumen de la cuenta). Elige tu protocolo en el desplegable y copia la Base URL correspondiente.
- Los prefijos de ruta cambian según el protocolo: copia siempre desde el diálogo;
- Los ejemplos de la documentación escriben
https://<your-base-url>; sustitúyelo por tu dirección real.
Autenticación por protocolo
| Protocolo | Cabeceras de autenticación | Notas |
|---|---|---|
| Compatible con OpenAI | Authorization: Bearer YOUR_API_KEY | Funciona con el SDK oficial de OpenAI: configura api_key + base_url |
| Anthropic | x-api-key: YOUR_API_KEY + anthropic-version: 2023-06-01 | La cabecera de versión es obligatoria; el SDK la envía automáticamente |
| Gemini | x-goog-api-key: YOUR_API_KEY | El ID del modelo va directamente en la ruta de la URL |
Errores de autenticación habituales
- 401 Unauthorized: la clave es incorrecta, se ha eliminado o ha caducado. Comprueba que usas la clave completa guardada al crearla, sin espacios ni saltos de línea sobrantes.
- Clave expuesta en código de frontend: todo lo que está en código de navegador es visible para cualquiera; las claves van en tu servidor o en variables de entorno locales.
- Claves confundidas: cada clave tiene su propio límite de gasto; asegúrate de usar la clave correcta para el entorno (producción / pruebas).
Para crear y custodiar claves, consulta Crear una clave de API.