Skip to main content
Las claves de API autentican las llamadas a la API, los SDK y las herramientas externas. Trata cada clave como acceso al saldo de tu cuenta.

Crear una clave

Abre Claves de API y crea una clave. El flujo habitual es:
  1. Ingresa un nombre. Usa el nombre del proyecto, el entorno o el nombre de la herramienta, como prod-web o cursor-local.
  2. Define una fecha de vencimiento. Las claves de prueba temporales deben tener un vencimiento corto.
  3. Define una cuota. La cuota ilimitada está activada de forma predeterminada; desactívala e ingresa un límite cuando quieras controlar el costo.
  4. Restringe modelos e IP de origen cuando sea necesario. Permite solo los modelos que necesita tu proyecto, o IP de salida fijas.
  5. Elige un grupo. Los grupos solo sirven para organizar las claves en la lista; no afectan los permisos, la cuota ni el enrutamiento.
  6. Crea varias claves si lo necesitas. Completa la cantidad cuando quieras varias claves con la misma configuración.
Si tu página muestra “Cross-group retry” (reintento entre grupos), es solo para el respaldo automático. El grupo en sí sigue siendo únicamente una etiqueta de gestión.
La clave completa se muestra solo una vez. Si se pierde, crea una nueva clave.

Usar una clave

Las solicitudes compatibles con OpenAI usan:
Los SDK normalmente aceptan solo el valor bruto de la clave, sin el prefijo Bearer .

Administrar claves

  • Ver el uso de una clave.
  • Editar cuota, vencimiento, límites de modelo, límites de IP y grupo.
  • Deshabilitar una clave temporalmente.
  • Eliminar de forma permanente las claves expuestas o sin uso.
Los grupos solo sirven para organización y filtrado; no cambian el control de acceso ni los resultados de las solicitudes.

Prácticas de seguridad

  • Usa claves separadas para desarrollo, producción, automatización y clientes externos.
  • Define límites de cuota para plugins de navegador, clientes de escritorio y pruebas temporales.
  • Guarda las claves en variables de entorno o en un gestor de secretos.
Si una clave queda expuesta, elimínala o deshabilítala de inmediato, crea una nueva clave, actualiza tu aplicación y revisa Uso en busca de llamadas anómalas.

Próximos pasos