No existe una clave API incluida por pagar ChatGPT Plus. La llamada “clave API de ChatGPT” es en realidad una clave de proyecto de OpenAI Platform. Se crea en Platform, su facturación se gestiona aparte, el valor completo solo se muestra una vez y nunca debe incluirse en código de navegador o móvil.
La configuración tampoco termina al copiar una cadena. Hay que demostrar tres estados diferentes: crear la clave, tener saldo o una prueba disponible y completar una llamada. Si uno falla, generar más claves no suele resolver el problema.
España figuraba en la lista oficial de países y territorios compatibles comprobada el 18 de julio de 2026. Si se utiliza la API desde otro lugar, manda la ubicación real y la lista vigente, no el idioma de esta página.
Respuesta rápida
- Inicia sesión en OpenAI Platform.
- Selecciona el proyecto correcto y abre API Keys.
- Crea una secret key con permisos mínimos y guarda el valor completo una sola vez.
- Revisa Billing en Platform; la suscripción de ChatGPT no cuenta como saldo de API.
- Carga el secreto como
OPENAI_API_KEYen un servidor. - Llama a
POST /v1/responsesy comprueba que la petición aparece en Usage.
| Estado | Prueba que debe verse | No demuestra ese estado |
|---|---|---|
| Clave creada | Registro en el proyecto y secret guardado | Tener una cuenta de ChatGPT |
| Facturación disponible | Billing muestra saldo o prueba específica de la cuenta | Pagar Plus/Pro o ver una clave |
| Integración operativa | Llega una respuesta y Usage la atribuye al proyecto | Copiar la clave en un bloc de notas |
ChatGPT y la Plataforma API son contratos distintos
OpenAI explica que ChatGPT y Platform usan sistemas de facturación separados. Una suscripción Plus o Pro no entrega créditos API. Recargar la API tampoco modifica el plan de ChatGPT.
Esta separación aclara dos búsquedas frecuentes:
- «Ya pago ChatGPT, ¿por qué la API pide saldo?» Porque la petición se cobra en API Platform.
- «¿Dónde está la clave en ChatGPT?» No está en el chat; está asociada a un proyecto de Platform.
Crear la clave actual, sin seguir capturas de 2023
Muchas guías todavía indican Personal > View API Keys. La interfaz y la organización por proyectos han cambiado. Utiliza el enlace actual y comprueba el proyecto antes de crear nada.
Pon un nombre que indique servicio y entorno, por ejemplo tienda-staging. OpenAI ofrece hoy All, Restricted y Read Only. Su guía de permisos permite definir None, Read o Write por endpoint. Si sabes qué API necesita la aplicación, concede solo ese acceso; no elijas All como respuesta automática.
Tras pulsar Create secret key, copia el valor a un gestor de secretos o contraseñas. El artículo oficial en español indica que el secret completo solo se muestra durante la creación. Si se pierde, no se recupera: se crea otra clave y se actualiza la aplicación.
Un documento de Word, una captura, un correo o un chat de equipo no son almacenes de secretos. Tampoco conviene que varias personas compartan la misma key: se pierde atribución y una sola filtración afecta a todos.
¿La clave API es gratis?
Crear la credencial no consume tokens. Eso no equivale a prometer créditos gratuitos fijos para toda cuenta nueva. El quickstart puede mostrar una prueba específica para una cuenta; la documentación de prepaid billing habla de consumir créditos gratuitos primero si existen. La fuente de verdad es el Billing dashboard de esa cuenta.
La documentación actual de Prepaid Billing indica que las cuentas API nuevas funcionan con prepago, que la compra mínima documentada es de 5 USD y que los créditos comprados caducan al año. Son datos variables: deben verificarse antes de pagar.
Si no se desea una compra automática, hay que desactivar auto-recharge y comprobar que quedó guardado. También pueden configurarse alertas, pero no deben confundirse con un corte técnico.
El presupuesto de proyecto no es un hard cap
Algunas páginas prometen que el «límite mensual» detendrá las llamadas. OpenAI aclara en Managing projects que el presupuesto de proyecto es un soft threshold y que las peticiones siguen ejecutándose después de superarlo.
Para un corte real, la aplicación debe imponer sus reglas: límite por usuario y minuto, máximo de tokens, número de reintentos, presupuesto interno y rechazo de tareas nuevas al alcanzar el umbral. La alerta sirve para avisar; no sustituye ese control.
Guardar OPENAI_API_KEY en el servidor
La guía de seguridad de OpenAI desaconseja distribuir keys en navegadores y apps móviles. Una variable .env incluida por el empaquetador del frontend también es pública.
En macOS o Linux se puede introducir el secret para una prueba local sin mostrarlo ni escribirlo en el historial como argumento:
bashread -s OPENAI_API_KEY export OPENAI_API_KEY
No se debe ejecutar echo $OPENAI_API_KEY. La comprobación segura devuelve únicamente «variable presente» o «ausente». En producción se utiliza el gestor de secretos de la plataforma.
Antes de pegar la key en una herramienta BYOK, hay que saber dónde se guarda, si llega a un servidor ajeno, cuánto tiempo conserva inputs y logs, cómo se elimina y cómo se reemplaza tras una rotación. Si esas respuestas no existen, se detiene la integración.
Primera llamada con Responses API
El Developer quickstart revisado el 18 de julio de 2026 utiliza Responses API:
bashcurl https://api.openai.com/v1/responses \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -d '{ "model": "gpt-5.6", "input": "Responde solamente: API_OK" }'
Si el modelo no aparece en el proyecto, se sustituye por un modelo de texto visible en el proyecto y en la documentación vigente. La disponibilidad del modelo es distinta de la validez de la clave.
Después de recibir el JSON, abre Usage y verifica el proyecto. La respuesta prueba que la petición se ejecutó; el registro de Usage prueba que se utilizó la propiedad esperada.
Si la aplicación ya ejecuta funciones propias con Chat Completions, cambiar solo la URL no completa la migración. Sigue la guía para migrar function calling a Responses API y adapta el esquema de herramientas, los function_call, la correlación por call_id y el bucle que ejecuta código en tu aplicación.
Cuando esa llamada mínima ya responde, decide qué contrato necesita el nuevo flujo: consulta cuándo usar Structured Outputs, function calling o ambos en Responses API antes de añadir un JSON Schema o un tool loop.
Qué revisar según el error
| Síntoma | Capa probable | Acción útil |
|---|---|---|
401 | Variable ausente, secret erróneo o revocado | Confirmar que el proceso lee la variable sin imprimirla; rotar si hace falta |
429 insufficient_quota | Billing o saldo API | Revisar Billing y Usage; Plus y nuevas keys no añaden saldo |
429 rate limit | Frecuencia o tokens | Reducir concurrencia, aplicar backoff y consultar límites actuales |
| Model not found | Modelo no disponible | Elegir uno que aparezca actualmente en el proyecto |
| Permission denied | Restricted key sin permiso | Abrir solo el Read/Write del endpoint necesario |
| Key publicada o enviada a un tercero | Incidente de seguridad | Revocar, crear otra, desplegarla y auditar Usage |
Para distinguir los 429, consulta OpenAI API quota exceeded. Si el fallo cambia al seleccionar otra organización o proyecto, revisa API key, organization y project.
Una pasarela compatible no entrega una clave oficial
Un gateway OpenAI-compatible utiliza otra credencial, otro base URL, otra factura y otra política de datos. Puede servir cuando el requisito real es cambiar entre modelos o contratar a otro proveedor, pero no debe venderse como «clave oficial de OpenAI gratis».
El 18 de julio de 2026 se verificó con navegador la documentación de LaoZhang API. Se presenta como plataforma de integración API para empresas y desarrolladores, y enlaza Quick Start, patrones compatibles con OpenAI y soporte de Responses API. Antes de elegirla hay que comprobar disponibilidad legal, términos, data policy, modelos, endpoints, facturación y soporte actuales.
Si el proyecto exige una cuenta y project oficiales de OpenAI, soporte directo o auditoría propiedad de OpenAI, una pasarela separada no encaja. La configuración está terminada cuando la ubicación es compatible, la key pertenece al proyecto correcto, sus permisos son mínimos, Billing está disponible, el secret vive solo en el servidor, la llamada responde y Usage la registra.
