Autenticación y claves de API
Cómo enviar tu clave de API y cómo limitar lo que puede hacer cada clave.
Cada solicitud lleva una de tus claves de API. Crea y administra tus claves en la página Claves de API de la consola.
Cómo enviar la clave
| Endpoint | Encabezado |
|---|---|
| Todos los endpoints | Authorization: Bearer sk-... |
/v1/messages (formato de Anthropic) | También acepta x-api-key: sk-... |
Los SDK oficiales configuran el encabezado correcto cuando les pasas api_key / apiKey.
Trata tus claves como contraseñas. Guárdalas en variables de entorno o en un gestor de secretos, nunca en código del lado del cliente ni en un repositorio público. Si una clave se filtra, elimínala en la consola y crea una nueva.
Límites de la clave
Para fijar los Límites de una clave, haz clic en Nueva clave en la página Claves de API de la consola, o en Editar junto a una clave existente. Cada uno de los cuatro límites tiene un interruptor: desactivado significa sin límite y, al activarlo, puedes establecer un valor. Los cambios se aplican de inmediato.
| Límite | Qué hace |
|---|---|
| Vencimiento | Elige 7 días, 30 días, 90 días, 1 año, o Personalizado para elegir una fecha. La clave deja de funcionar ese día a las 23:59, hora local, y las solicitudes devuelven 401. |
| Límite de gasto | Un monto en dólares estadounidenses. Cuando la clave haya gastado este monto, deja de funcionar y las solicitudes devuelven 401. Al editar una clave, es lo que le queda por gastar; si lo cambias, se restablece. |
| Modelos permitidos | Elige modelos del catálogo o escribe un ID de modelo que no aparezca, hasta 50. Las llamadas a cualquier otro modelo devuelven 403. |
| Lista de IP permitidas | Una dirección IP o rango CIDR por línea, hasta 20. Las solicitudes desde cualquier otra dirección devuelven 403. |
Al editar una clave, el Vencimiento y el Límite de gasto se mantienen igual, a menos que los cambies. En la lista de claves, la columna Presupuesto muestra lo disponible y lo gastado de cada clave, y Estado muestra Vencida o Presupuesto agotado cuando una clave alcanza uno de estos límites. El límite de gasto nunca le permite a una clave gastar más que el saldo de tu cuenta.
Una clave por aplicación
Dale a cada aplicación, entorno o integrante de tu equipo su propia clave. Así puedes ver su gasto en la lista de claves, ponerle un límite de gasto y eliminarla sin afectar nada más.