OpenAI API key: crea tu clave y prueba la API paso a paso

1. Inicia sesión y elige el proyecto adecuado

Abre platform.openai.com y crea una cuenta o inicia sesión. Completa los pasos de configuración que aparezcan. La guía de inicio rápido de OpenAI incluye un enlace directo al panel de claves de API.

Imagina que la cuenta es tu credencial de empleado; la organización, la empresa; y el proyecto, una sala asignada a una aplicación. La clave es la credencial que usa tu software para entrar en esa sala.

Elige la organización correspondiente en el selector de organizaciones. Selecciona un proyecto existente o, si eres propietario de la organización, usa la opción Create project del menú de proyectos y completa sus datos. Un nombre como website-test ayuda a identificar para qué sirve. La guía de proyectos de OpenAI explica estos controles.

Si trabajas para una empresa, pide al propietario que te añada al proyecto adecuado. Evita empezar una integración para un cliente desde una cuenta con facturación personal solo porque ya tienes la sesión abierta.

2. Cómo crear tu OpenAI API key en el proyecto

En la configuración de la organización, selecciona tu proyecto, abre API Keys y elige + Create new secret key. La clave quedará vinculada al proyecto seleccionado. Instrucciones para crear claves de proyecto.

Para tu primera prueba, usa una clave de proyecto asociada a tu usuario. Si se te pide un nombre, elige uno fácil de reconocer, como local-test. Selecciona los permisos Restricted y habilita las operaciones que necesite tu aplicación. All concede acceso completo y es la opción predeterminada; Read Only limita la clave a operaciones de lectura. Permisos de las claves de API. Para la prueba de esta guía, permite crear Responses: OpenAI denomina ese permiso api.responses.write. Permiso de creación de respuestas.

Copia la clave secreta de inmediato y guárdala en un lugar seguro. OpenAI solo muestra su valor completo al crearla. Si la pierdes, tendrás que generar otra: no puedes volver a consultar la original. Dónde encontrar y gestionar las claves de API.

Define una fecha de caducidad y deja constancia de quién sustituirá la clave. Las políticas de tu organización pueden exigir que caduque o restringir los tipos de clave que puedes crear. Si alguna opción no está disponible, consulta la política con el administrador. Recomendaciones de OpenAI para producción. Revisa el plan de caducidad y rotación de claves de API antes de que una prueba se convierta en un servicio en funcionamiento.

Cuándo conviene una clave de cuenta de servicio

Para una aplicación desplegada o un flujo de trabajo programado del equipo, yo usaría una cuenta de servicio: una identidad del software, en lugar de una persona. El propietario de la organización o del proyecto puede crearla en Members → + Service account, dentro del proyecto seleccionado. Guarda la clave generada de inmediato. Usa un proyecto dedicado: las cuentas de servicio no se pueden añadir directamente al proyecto Default. Configuración de cuentas de servicio.

Una vez creada, revisa su acceso en API Keys, dentro de la configuración del proyecto. El cuadro de creación de cuentas de servicio no ofrece los mismos controles de permisos que una clave asociada a un usuario. Diferencias entre permisos. La ventaja operativa es que queda claro quién responde por la credencial de la aplicación aunque cambien los integrantes del equipo.

3. Configura la facturación de la API y limita el gasto

La facturación de ChatGPT y la de la API son independientes. Pagar ChatGPT no configura los pagos de la API. Abre el resumen de facturación de la API de la organización correspondiente; su propietario puede gestionar la facturación. Guía de facturación de OpenAI.

Las cuentas nuevas de la API usan facturación de prepago. Selecciona Add payment details, completa los datos de pago, elige la compra inicial de créditos y confirma. Antes de pagar, revisa Use auto-reload: según OpenAI, la recarga automática está activada de forma predeterminada. Desactívala si quieres hacer una prueba con recargas manuales, o configura expresamente su umbral y el límite mensual de recargas. La compra puede tardar unos minutos en reflejarse. Configuración del prepago.

Consulta las tarifas vigentes de los modelos en la página de precios de OpenAI. La guía de precios de la API de OpenAI de este sitio te ayuda a situarlas en el presupuesto de una aplicación.

Activa el límite estricto para detener las solicitudes

En Project settings → Limits → Spend → Edit spend limit, indica el límite de gasto mensual en Monthly spend limit, activa Enforce a hard limit y guarda los cambios. Necesitas permiso para gestionar la configuración de ese proyecto. Añade una alerta de gasto por debajo del límite para que alguien pueda actuar antes de que se detenga el servicio. Instrucciones para limitar el gasto.

El bloqueo por límite estricto se aplica con cierto retraso, por lo que el gasto registrado puede superar ligeramente el importe configurado. Un límite estricto de organización abarca el conjunto de sus proyectos. El saldo de prepago también puede sobrepasarse mientras se aplica el corte, y las compras manuales quedan fuera del límite de recargas automáticas. Funcionamiento de los límites estrictos, funcionamiento del prepago.

Antes de pasar a producción, lee la guía de límites estrictos de gasto de la API de OpenAI y decide quién podrá elevar el tope si interrumpe el servicio.

4. Guarda la clave para que tu aplicación la use de forma segura

Guarda la clave en un gestor de secretos, un sistema diseñado para almacenar credenciales, o pásala a tu servidor mediante una variable de entorno llamada OPENAI_API_KEY. Una variable de entorno es un ajuste con nombre que el programa puede leer mientras se ejecuta, sin incluir el secreto en el código fuente. Recomendaciones de almacenamiento en producción.

No incluyas una clave secreta de API estándar en el JavaScript de un sitio web, una aplicación móvil, un repositorio, una captura de pantalla o un mensaje de soporte. El código del navegador y de las aplicaciones móviles llega a los dispositivos de los usuarios; el secreto debe quedarse en tu servidor, que se encargará de hacer la solicitud. Da a cada integrante del equipo su propio acceso en lugar de compartir la clave de una persona. Seguridad de las claves de API.

Si una herramienta te pide que pegues una clave: usa únicamente el campo para credenciales que indique su documentación, y solo si confías en entregar esa credencial al proveedor. Recomiendo un proyecto dedicado y una clave con permisos restringidos para esa integración, con un tope de gasto y una persona responsable. Un campo de texto genérico, un mensaje de chat o un supuesto «verificador de claves» que no conoces no son lugares adecuados para diagnosticar la conexión. Pregunta al proveedor qué permisos necesita y dónde guarda el secreto.

5. Haz una prueba con una solicitud de curl

Ejecuta lo siguiente en Bash, en tu computadora. curl es una herramienta de línea de comandos que envía solicitudes web. Las primeras líneas te piden la clave sin mostrarla en pantalla ni incluir su valor literal en el comando que escribes; la variable de entorno dura lo que dure esa sesión de shell.

read -r -s -p "OpenAI API key: " OPENAI_API_KEY
printf '\n'
export OPENAI_API_KEY

curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-6-astra",
    "input": "Reply with a short greeting."
  }'

La prueba usa la estructura de solicitud y el modelo del ejemplo de generación de texto de OpenAI. La Responses API es el endpoint que recibe tu entrada y devuelve la salida del modelo. El encabezado de autorización contiene la clave secreta; el cuerpo JSON selecciona el modelo y proporciona la instrucción. Esta solicitud consume la API, así que la facturación y el acceso al modelo deben estar configurados.

Una respuesta correcta contiene un arreglo output con un mensaje cuyo contenido incluye output_text. Busca allí el saludo. No des por hecho que el texto siempre está en el primer elemento del arreglo. Si recibes un objeto error, consulta su mensaje y su código con ayuda de la sección siguiente. Estructura de las respuestas.

Después de la prueba, ejecuta unset OPENAI_API_KEY para borrar la variable de esa sesión cuando ya no la necesites. Al desplegar la aplicación, configura el secreto en el entorno de alojamiento en lugar de volver a introducirlo en la terminal.

¿La clave no funciona? Revisa esto primero

Lee el error antes de crear otra clave. Varios fallos no tienen nada que ver con el secreto en sí.

Una respuesta 429 puede indicar un problema de gasto o de créditos, además de un límite de solicitudes. Reintentar no repone créditos ni cambia un tope configurado. Códigos de error de OpenAI, permisos de las claves.

Si se filtra tu clave de API, revócala de inmediato

Considera expuesta cualquier clave secreta que hayas pegado en un repositorio público, una captura de pantalla o un mensaje. Borrar la copia visible no invalida las que alguien ya haya obtenido.

1. Revoca la clave expuesta. Abre la página de claves de API en el proyecto correcto y elimina la clave. Las aplicaciones que la usen podrían dejar de funcionar hasta que la sustituyas. Eliminación de claves.
2. Crea una clave nueva y actualiza las aplicaciones afectadas. Prueba la nueva clave y comprueba que los procesos desplegados la estén usando.
3. Revisa el uso y la facturación. Investiga las solicitudes inesperadas y contacta con el soporte de OpenAI si sospechas un uso indebido. OpenAI recomienda rotar la clave de inmediato ante la sospecha de una filtración. Cómo actuar ante una filtración.
4. Corrige el origen de la exposición. Elimina el secreto del código y de los registros, y corrige la forma de almacenarlo o compartirlo que provocó la filtración. Si la cuenta también pudiera estar comprometida, cambia la contraseña, cierra las demás sesiones y denuncia la actividad no autorizada. Pasos para recuperar la cuenta.

Cinco situaciones en las que esta configuración resulta útil

El beneficio es tener una integración con un responsable y un presupuesto definidos. Estas son formas prácticas de aplicarla en un equipo, ordenadas por su utilidad inmediata.

Que una clave funcione demuestra que se puede ejecutar una solicitud. No demuestra que tus prompts sean fiables, que un proveedor gestione bien las credenciales ni que debas dar a una automatización acceso a datos de clientes. Esas siguen siendo decisiones de producto y de operación.

Dos funciones útiles que puedes desarrollar a partir de esta configuración

La oportunidad más sólida es un asistente de conexión integrado en un software que pide a sus clientes una clave de OpenAI. DataForSEO estima 1,000 búsquedas mensuales en Estados Unidos para «how to get openai api key». Es una señal de dificultades al configurar el acceso, no una previsión de clientes de pago. Un proveedor podría comprar o desarrollar una lista guiada de comprobaciones del proyecto, un campo seguro para la credencial, un botón de prueba claramente identificado y un resultado fácil de entender. La versión mínima debería estar dentro del producto que necesita la conexión. El obstáculo: los proveedores pueden desarrollarla por su cuenta, así que su valor debe estar en reducir la carga de soporte y mantener las instrucciones al día.

Una herramienta que explique los errores es útil para soporte, pero tiene menos demanda como producto independiente. La misma consulta estima solo 10 búsquedas mensuales en Estados Unidos para «openai api key not working». Un proveedor de automatizaciones o una agencia de implementación podría ofrecer un formulario que acepte el código y el mensaje del error sin datos sensibles, y explicar después si hay que corregir las credenciales, los créditos, los permisos o la frecuencia de las solicitudes. Su primera versión necesita una tabla de decisiones actualizada, no quedarse con la clave del usuario. Las limitaciones son el escaso volumen de búsquedas medido y que muchas herramientas ya muestran esos errores. Yo lo incorporaría al proceso de configuración inicial en lugar de lanzar un producto de pago independiente.

Son estimaciones de DataForSEO obtenidas mediante su consulta de resumen de palabras clave para búsquedas en inglés en Estados Unidos y verificadas para esta guía. Miden búsquedas, no usuarios únicos ni intención de compra.

Tu tarea para el lunes: elige una integración, asigna un responsable, crea su proyecto, configura el control de gasto y guarda el resultado de una prueba correcta sin incluir el secreto. Así dejarás una referencia útil para quien se encargue del mantenimiento después.

Si necesitas ayuda para llevar esa integración a producción, la página de sistemas de IA en producción explica el trabajo operativo que la acompaña.