Autenticación
Cómo enviar tu clave, qué encabezado espera cada formato y cómo mantener las claves seguras.
Cada solicitud necesita una clave de API creada en tu panel. Las claves empiezan por sk- y tienen los permisos y el saldo de la cuenta que las creó.
Dos encabezados, una clave
La misma clave funciona en ambos formatos; solo cambia el nombre del encabezado.
| Formato | Endpoint | Cabecera |
|---|---|---|
| Anthropic | /v1/messages | x-api-key: sk-... |
| Anthropic (alt) | /v1/messages | Authorization: Bearer sk-... |
| OpenAI | /v1/chat/completions | Authorization: Bearer sk-... |
El formato de Anthropic también requiere un encabezado de versión. Cualquier SDK de Anthropic lo establece automáticamente:
-H "anthropic-version: 2023-06-01"Variables de entorno
La mayoría de las herramientas leen estas variables en lugar de recibir una clave como argumento:
| Variable | Utilizada por | Valor |
|---|---|---|
ANTHROPIC_BASE_URL | Claude Code, SDK de Anthropic | https://aiprimetech.io |
ANTHROPIC_AUTH_TOKEN | Claude Code | tu sk- clave |
ANTHROPIC_API_KEY | SDK de Anthropic (Python/TS) | tu sk- clave |
OPENAI_BASE_URL | SDK de OpenAI, LangChain, LiteLLM | https://aiprimetech.io/v1 |
OPENAI_API_KEY | SDK de OpenAI | tu sk- clave |
Fíjate en el campo
/v1 como sufijo en OPENAI_BASE_URL pero no en ANTHROPIC_BASE_URL. Esa asimetría está en los SDK oficiales; no la hemos introducido nosotros. El cliente de OpenAI añade rutas a la base que le proporcionas, mientras que el cliente de Anthropic añade /v1 por sí mismo. Equivocarse en esto es el error de configuración más común.Buenas prácticas para las claves
- Crea una una clave distinta por máquina o proyecto para poder revocar una sin afectar a las demás.
- Nunca incluyas claves en los commits. Usa variables de entorno o un gestor de secretos; añade
.enva.gitignore. - Las claves se muestran completas una sola vez. Rota la clave en lugar de intentar recuperar una que hayas perdido.
- Una clave filtrada consume tu saldo. Revócala inmediatamente en el panel: la revocación es instantánea.
- Da prioridad a las llamadas desde el servidor. Una clave incluida en un paquete de navegador o una aplicación móvil es una clave pública.
Revocación y rotación
- Panel → Claves de API.
- Crea primero la clave de reemplazo y despliégala.
- Elimina la clave antigua una vez que el tráfico haya migrado. Las solicitudes en curso que la utilicen fallarán inmediatamente después de eliminarla.