Clave API de OpenAI gratis: comprueba tu cuenta antes de empezar

Crear una clave API de OpenAI no equivale a recibir saldo gratis. El inicio rápido oficial describe una primera petición de prueba gratuita, pero no garantiza esa posibilidad para todas las cuentas ni publica una cantidad, duración o lista universal de modelos. Antes de ejecutar código, comprueba tu país y lo que muestra Billing en tu propia cuenta.

Si tu cuenta permite la prueba, podrás crear una clave de proyecto, hacer una petición real y confirmar el resultado en Usage. Si solicita créditos o un método de pago, no hay un truco legítimo que convierta una clave pública o compartida en una clave oficial gratis: tendrás que añadir saldo o detenerte.

La comprobación de 60 segundos: ¿puedes continuar?

Haz estas comprobaciones en orden:

1. Ubicación: abre la lista oficial de países y territorios compatibles. España figuraba en ella al comprobarla el 25 de agosto de 2026. Verifica de nuevo la lista desde tu ubicación real, porque puede cambiar.
2. Cuenta: entra directamente en OpenAI Platform y selecciona tu proyecto. No confundas esta consola con ChatGPT.
3. Facturación: revisa Billing. Si ves crédito disponible o tu onboarding permite la petición de prueba, puedes seguir. Si el saldo es cero y la interfaz exige comprar créditos, la prueba sin pago no está disponible para esa cuenta en ese momento.
4. Límites: no deduzcas un importe o una caducidad a partir de tutoriales antiguos. La documentación pública no garantiza cuánto ofrece la prueba a una cuenta concreta.

La distinción importante es sencilla: la clave autentica; el saldo paga el uso. Tener una cadena que empieza por un prefijo de secreto no demuestra que haya cuota, permisos o crédito detrás.

ChatGPT Plus no incluye el uso de la API

ChatGPT y OpenAI Platform tienen facturación separada. Una suscripción a ChatGPT Plus, Business, Enterprise o Edu no se convierte en saldo para llamadas API. El Playground también consume API y se factura como tal.

Por eso, si ya pagas ChatGPT y una petición devuelve un error de cuota, comprueba Billing en Platform; no busques la clave dentro de ChatGPT ni contrates otra suscripción esperando que active la API.

Crea una clave propia de proyecto

Cuando la comprobación anterior sea favorable:

1. Abre la página de claves de API dentro del proyecto correcto.
2. Crea una clave nueva y aplica los permisos mínimos que necesite tu prueba.
3. Copia el secreto en ese momento. OpenAI solo muestra la clave completa al crearla.
4. Guárdala en un gestor de secretos o como variable de entorno. Si la pierdes, crea otra; no podrás volver a revelar el valor completo.

Usa una clave distinta para cada persona o servicio. No pegues una clave real en un repositorio, una captura, un formulario, un chat ni una incidencia de soporte.

Guarda el secreto fuera del código

En macOS o Linux, asigna la clave a una variable de entorno en la sesión actual:

bash
export OPENAI_API_KEY="tu_clave_recien_creada"

No añadas esa línea con el valor real a un archivo que se suba a Git. En producción, configura el secreto en el servidor o en el gestor de secretos de tu plataforma.

Una aplicación web o móvil tampoco debe llamar a OpenAI directamente con tu clave. El navegador o la app pueden inspeccionarse; envía la solicitud a tu backend y deja que el servidor use el secreto.

Ejecuta una primera petición verificable

La prueba siguiente usa el SDK oficial de Python y la Responses API. No fija un modelo concreto porque los modelos habilitados dependen del proyecto y cambian con el tiempo.

Instala el SDK:

bash
python -m pip install openai

Define también un modelo que esté disponible en tu proyecto, según la documentación o el selector actual de Platform:

bash
export OPENAI_MODEL="modelo-disponible-en-tu-proyecto"

Crea prueba_openai.py:

python
import os
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model=os.environ["OPENAI_MODEL"],
    input="Responde únicamente con: conexión correcta",
)

print(response.output_text)

Y ejecútalo:

bash
python prueba_openai.py

Una respuesta válida demuestra tres cosas en ese momento: la clave funciona, el proyecto permite ese modelo y la cuenta puede financiar la petición. No demuestra que el uso futuro sea gratis. Abre Usage y comprueba que la llamada aparece asociada al proyecto esperado; después revisa Billing para ver el saldo o cargo correspondiente.

Si falla, interpreta el error antes de repetir

Repetir una petición sin entender el fallo puede consumir tiempo o aumentar costes. Usa el mensaje completo y el estado de la cuenta para decidir:

• Clave no válida o error de autenticación: confirma que OPENAI_API_KEY pertenece al proyecto correcto y no contiene espacios. Si pudo filtrarse, revócala y crea otra.
• Cuota insuficiente o saldo agotado: crear otra clave no añade crédito. Revisa Billing y los límites del proyecto.
• Modelo inexistente o sin acceso: elige un modelo que la cuenta tenga habilitado; no asumas que el nombre de un tutorial antiguo sigue vigente.
• Permiso denegado: revisa los permisos de la clave y el proyecto seleccionado. Amplíalos solo cuando la operación lo necesite.
• Restricción geográfica: detente. No uses VPN, cuentas prestadas ni terceros para eludir la lista oficial.
• Límite de velocidad: respeta el tiempo de espera indicado y añade reintentos con pausa; no lances un bucle inmediato.

Si una clave aparece en GitHub, un vídeo, un foro o un grupo, trátala como comprometida. Puede pertenecer a otra persona, registrar tus datos, desaparecer sin aviso o generar cargos ajenos. OpenAI indica que las claves no deben compartirse.

Qué cuesta después de la prueba

El uso continuado de la API se cobra por consumo. La página oficial de precios separa, según el modelo y la herramienta, entrada, entrada en caché, salida y otros cargos. Consulta esa página justo antes de calcular un presupuesto: los modelos y tarifas cambian.

La documentación de facturación prepago indicaba el 25 de agosto de 2026 que las cuentas nuevas usan prepago, con una compra mínima documentada de 5 USD y 10 USD como importe predeterminado. También señala que los créditos comprados caducan al año y no son reembolsables. Son condiciones volátiles: confirma lo que muestra tu cuenta, incluidos impuestos, moneda y método de pago aplicables en España.

Configura un presupuesto y alertas, pero no los trates como un interruptor perfecto. Supervisa Usage, limita los permisos y separa proyectos de pruebas y producción.

¿Y los tokens diarios gratuitos por compartir datos?

Algunas organizaciones pueden ver en Data Controls una opción de tokens diarios complementarios para tráfico elegible compartido con OpenAI. No es un nivel gratuito universal: requiere elegibilidad explícita, consentimiento, saldo positivo y modelos o tráfico compatibles; los excesos se facturan normalmente.

No actives el intercambio solo para ahorrar. Revisa primero qué datos enviarías y excluye información sensible, confidencial o propietaria.

Preguntas frecuentes

¿Crear una clave API cuesta dinero?

Crear la credencial no demuestra ni consume por sí mismo saldo. El coste aparece al usar la API, salvo que la cuenta muestre una prueba o crédito aplicable. Comprueba Billing antes de llamar.

¿Todas las cuentas nuevas reciben crédito gratis?

No hay una garantía pública universal. El quickstart oficial describe una petición de prueba gratuita, pero no publica para todas las cuentas su elegibilidad, importe, duración, modelos o necesidad de método de pago. La interfaz autenticada de tu cuenta es la comprobación decisiva.

¿Puedo usar una clave de API gratis de GitHub?

No. Una clave publicada es un secreto comprometido, no una alternativa segura. Podría dejar de funcionar, exponer tus solicitudes o cargar el uso a otra persona. Crea y protege tu propia clave.

¿Puedo poner la clave en JavaScript del navegador?

No. Cualquier visitante podría extraerla. Mantén la clave en el backend y ofrece al frontend un endpoint propio con autenticación, límites y validación.

¿Cómo sé si la primera llamada fue realmente gratis?

No lo deduzcas solo porque obtuviste una respuesta. Contrasta la llamada en Usage y el movimiento en Billing. Esas pantallas reflejan el estado de tu cuenta; una guía pública no puede hacerlo.

La regla práctica

Continúa únicamente si tu ubicación es compatible, tu propia cuenta muestra una vía de prueba o saldo aceptable y puedes guardar la clave en un backend. Cuando falte cualquiera de esas tres condiciones, detente: una clave compartida, una suscripción de ChatGPT o una promesa antigua de créditos no resuelven el problema.

Empieza por el quickstart oficial de OpenAI, valida una sola petición y comprueba Usage y Billing antes de integrar nada más.