← Blog  /  ■ Herramientas IA

OpenAI API key: cómo obtenerla y configurarla paso a paso

Pagas ChatGPT Plus y aun así una herramienta te pide una llave. No es un error: la API de OpenAI es otro producto, con otra cuenta y otra factura. Así se configura bien desde el primer día.

Por Luisa Navarro · 18/10/2026 · 10 min de lectura

Luisa Navarro es cofundadora de PorContar, ingeniera industrial, magíster en Big Data y magíster en inteligencia artificial. Enseña a equipos de empresa a llevar la IA a sus procesos reales.

Para obtener tu OpenAI API key, crea una cuenta en platform.openai.com, carga créditos en la facturación de tu organización y genera la llave en Settings → Organization → API keys. La API se paga aparte de ChatGPT Plus, por consumo de tokens, y la llave se guarda en una variable de entorno, nunca dentro del código.

Esta guía es para quien tiene que dejarla funcionando: el desarrollador, la analista que arma una automatización o el gerente que necesita entender qué está aprobando. Las rutas, los precios y el código están verificados en la documentación oficial de OpenAI a octubre de 2026.

Qué es la API de OpenAI y para qué sirve

La API de OpenAI es la puerta para usar los modelos de OpenAI desde tus propios sistemas, sin abrir ChatGPT. En vez de escribir en un chat, un programa le manda la instrucción y recibe la respuesta: un CRM que resume correos, una hoja de cálculo que clasifica solicitudes, un flujo que redacta borradores para que alguien los revise.

La API key es la contraseña de ese acceso. Identifica a tu organización en cada llamada y es la base del cobro. Quien la tenga puede gastar tu saldo.

El cobro es por tokens: los pedazos de texto que el modelo lee y escribe. Lo que lee (entrada) cuesta menos que lo que escribe (salida).

¿La API de OpenAI es gratis? ChatGPT Plus no la incluye

No. La API se paga por uso y aparte de cualquier plan de ChatGPT. La ayuda oficial de OpenAI dice que ChatGPT y la plataforma de la API tienen sistemas de facturación separados, y en la descripción de ChatGPT Plus el uso de la API aparece como no incluido. Lo mismo dicen las páginas de los planes Go y Business.

Es la confusión más común. Alguien paga Plus, intenta conectar una herramienta y descubre que necesita otra cuenta de pago. No es un error de configuración: son dos productos.

Existe una función llamada «Sign in with ChatGPT» que deja usar la cuota de tu plan en algunas aplicaciones de terceros. Eso no es la API y no te da una llave.

¿Y el nivel «Free» que aparece en la documentación? Es un tope de uso para cuentas en países habilitados, no un saldo de regalo. La documentación no dice qué modelos se pueden usar en ese nivel, así que no armes un proyecto contando con él.

En cortoChatGPT Plus es para conversar en la app. La API es para conectar los modelos a tus sistemas. Se pagan por separado.

Cómo obtener la API key de OpenAI paso a paso

La consola de la API (cuenta, llaves y facturación) vive en platform.openai.com. La documentación se mudó a developers.openai.com: si entras a la dirección vieja, te redirige.

  1. Crea la cuenta en la plataforma

    Regístrate en platform.openai.com/signup. Es la cuenta de la plataforma de la API, con su propia facturación.

  2. Verifica lo que te pida

    Al generar la primera llave puede pedirte verificar un número de teléfono. Algunos modelos o funciones exigen además verificar la organización en Settings → Organization → General → Verify Organization, con un documento de identidad oficial y físico. Un documento solo sirve para verificar una organización.

  3. Agrega un método de pago y carga créditos

    En la facturación (Billing) de la organización agregas la tarjeta y compras saldo. Más abajo está el detalle del mínimo y del vencimiento.

  4. Crea la llave

    Entra a Settings → Organization → API keys (platform.openai.com/settings/organization/api-keys) y crea una llave nueva. Ponle un nombre que diga para qué es, como «crm-produccion» o «pruebas-automatizacion». Si es una llave de proyecto, ponle fecha de vencimiento: lo recomienda la guía de buenas prácticas de OpenAI.

  5. Guárdala en una variable de entorno

    Copia la llave y guárdala en la variable de entorno OPENAI_API_KEY, un valor que tu computador o servidor guarda fuera del código. Los SDK oficiales (las librerías de OpenAI para cada lenguaje de programación) la leen solos, así que la llave nunca tiene que aparecer en tu código.

Variable de entorno · comandos de la documentación oficial
# macOS / Linux
export OPENAI_API_KEY="your_api_key_here"

# Windows (PowerShell)
setx OPENAI_API_KEY "your_api_key_here"

Reemplaza your_api_key_here por tu llave. En Windows, setx deja la variable para las terminales que abras después, no para la que tienes abierta.

Cómo se recargan los créditos: mínimo y vencimiento

La API de OpenAI es prepago: compras créditos y se van descontando según los tokens que consumes. Según la ayuda de OpenAI, a octubre de 2026:

  • La recarga mínima es de USD 5. El valor que aparece preseleccionado es USD 10.
  • La recarga automática viene activada por defecto al configurar el pago, también con un mínimo de USD 5.
  • Los créditos vencen al año de comprados y el plazo no se puede extender.
  • En general no son reembolsables, salvo error de facturación verificado, uso no autorizado confirmado o falla del servicio.

La compra se hace en la página de facturación (Billing) de la organización, desde la opción para comprar o agregar crédito.

Ojo con la recarga automática: viene encendida. Si una automatización se queda repitiendo llamadas, la tarjeta sigue recargando. Configura un límite duro de gasto antes de la primera prueba; está explicado en la sección de seguridad.

Niveles de uso de la API de OpenAI

OpenAI ordena las cuentas por niveles según lo que has comprado en créditos, y cada nivel tiene un tope de uso mensual. A octubre de 2026, la documentación lista cuatro:

NivelRequisitoTope de uso
FreeEstar en un país habilitadoUSD 100 al mes
BuildUSD 5 en compras de crédito acumuladasUSD 500 al mes
LaunchUSD 100 en compras acumuladasUSD 5.000 al mes
GrowUSD 500 en compras acumuladasUSD 200.000 al mes

Los tres niveles pagos son Build, Launch y Grow. El nivel sube solo cuando tus compras acumuladas pasan cada umbral, y también puedes pedir el cambio en Settings → Organization → Limits → Usage Tiers → Upgrade tier.

Si un tutorial te habla de «Tier 1» a «Tier 5», está desactualizado: esos nombres ya no aparecen en la documentación. Scale Tier y Reserved Tier sí existen, pero son opciones de capacidad, no niveles de uso.

Precio de la API de OpenAI: modelos y costo por millón de tokens

La API cobra por millón de tokens, con un precio para lo que el modelo lee y otro, más alto, para lo que escribe. Estos son los modelos vigentes en el nivel Standard, para peticiones de hasta 272.000 tokens de entrada, en USD por millón de tokens, a octubre de 2026:

Modelo (ID en la API)EntradaEntrada en cachéSalidaPara qué, según OpenAI
gpt-6-astra10,001,0050,00El más capaz, para el trabajo más exigente
gpt-6.1-sol2,000,1010,00Cerca de Astra en trabajo complejo, a menor costo
gpt-6-luna0,100,010,50El más eficiente, para tareas puntuales y de alto volumen
gpt-6-sol2,000,2010,00No figura entre los modelos insignia
gpt-5.6-sol4,000,4020,00Generación anterior

Los tres modelos insignia (GPT-6 Astra, GPT-6.1 Sol y GPT-6 Luna) tienen una ventana de contexto (lo máximo que leen en una sola petición) de 1,05 millones de tokens. Por encima de 272.000 tokens de entrada el precio sube: GPT-6 Astra pasa a USD 20 de entrada y USD 75 de salida; GPT-6.1 Sol, a USD 4 y USD 15; GPT-6 Luna, a USD 0,20 y USD 0,75.

Hay otros modos de servicio. Batch y Flex cuestan la mitad de Standard. Fast, que antes se llamaba «Priority processing», cuesta el doble.

La recomendación oficial para empezar es GPT-6 Astra. La nuestra, para una empresa, es otra: prueba la tarea con el modelo más barato que pueda resolverla y sube solo si falla. Entre GPT-6 Luna y GPT-6 Astra hay 100 veces de diferencia en el precio por token.

¿Tu equipo ya paga ChatGPT y no pasa del chat?

En la capacitación cada área aprende a usar ChatGPT Business o Enterprise sobre sus propias tareas, con reglas claras de qué información entra a la herramienta.

Ver la capacitación en ChatGPT para empresas →

Tu primera llamada: el ejemplo mínimo oficial

Con la llave en la variable de entorno, este es el ejemplo del quickstart oficial de OpenAI, tal como aparece hoy. Primero instala la librería:

Instalación
pip install openai
Python · quickstart oficial de OpenAI
from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-6-astra",
    input="Write a one-sentence bedtime story about a unicorn.",
)

print(response.output_text)

Lo mismo desde la terminal, con curl, según la guía oficial de generación de texto:

curl · guía oficial de generación de texto
curl "https://api.openai.com/v1/responses" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
        "model": "gpt-6-astra",
        "input": "Write a one-sentence bedtime story about a unicorn."
    }'

Dos detalles que ahorran una tarde. Los ejemplos actuales usan la Responses API (/v1/responses), no la ruta chat/completions de muchos tutoriales viejos. Y el cliente de Python no recibe la llave como parámetro porque la lee de OPENAI_API_KEY. Si te responde una frase sobre un unicornio, tu llave funciona.

Cómo proteger tu OpenAI API key

OpenAI lo dice sin rodeos: tu API key es un secreto. Quien la tenga gasta tu saldo. Estas son las reglas de su guía de buenas prácticas:

  • Nunca en el código ni en un repositorio público. Tampoco en código que corre en el navegador o en una app, donde cualquiera puede leerla.
  • Cárgala desde una variable de entorno o desde un gestor de secretos en el servidor.
  • Ponle fecha de vencimiento y rótala: creas la nueva, cambias las aplicaciones y revocas la vieja. Revocar una llave surte efecto en segundos.
  • Separa proyectos de pruebas y de producción, cada uno con sus propios límites de gasto y de uso.
  • Una llave por persona. Según la ayuda de OpenAI, compartir llaves va contra los términos de uso.

Límites de gasto

En platform.openai.com/settings/organization/limits configuras alertas de gasto por correo y un límite duro («hard spend limit») que detiene el tráfico cuando se llega al tope. El consumo lo ves en platform.openai.com/settings/organization/usage. Hazlo el mismo día que creas la llave, no después de la primera factura.

Errores comunes al configurar la API de OpenAI

  • Creer que ChatGPT Plus incluye la API. Son dos cuentas de pago distintas.
  • Pegar la llave en el código «para probar rápido». Ese archivo termina en un repositorio, en un correo o en una captura de pantalla.
  • Dejar la recarga automática sin límite duro. Viene encendida por defecto.
  • Copiar tutoriales viejos: la ruta chat/completions, niveles «Tier 1 a Tier 5» o modelos que ya no están en la lista. Compara siempre con developers.openai.com.
  • Una sola llave para todo el equipo. Cuando se filtra o alguien se va, revocarla tumba todas las integraciones a la vez.
  • Usar el modelo más caro para todo. Clasificar correos no necesita el modelo insignia.
  • Ignorar la verificación de la organización cuando un modelo o una función la pide.
  • En Windows, probar en la misma terminal donde corriste setx. Abre una nueva.

Cómo llevar la API de OpenAI al trabajo de tu equipo

Obtener la llave es la parte fácil. Lo difícil es decidir qué proceso conectar, qué información puede salir hacia la API y quién revisa lo que vuelve. Eso no lo resuelve la documentación: lo resuelve el criterio del equipo, y por eso en PorContar damos capacitación en IA para empresas sobre el trabajo real de cada área.

¿Estás comparando proveedores? La misma guía existe para la Claude API key y para la API de Perplexity.

Antes de conectar la API, mide cómo usa la IA tu equipo

El diagnóstico es gratuito y toma dos minutos: ves en qué nivel de adopción está tu equipo y por dónde conviene empezar.

Hacer el diagnóstico de IA →

Preguntas frecuentes

¿Cómo obtener la API key de OpenAI?
Crea una cuenta en platform.openai.com, agrega un método de pago y compra créditos en la facturación de la organización, y genera la llave en Settings → Organization → API keys. Después guárdala en la variable de entorno OPENAI_API_KEY: los SDK oficiales la leen solos.
¿La API de OpenAI es gratis?
No. Funciona con créditos prepagados que se descuentan según los tokens que consumes. El nivel Free que aparece en la documentación es un tope de uso, no un saldo de regalo, y la documentación no dice qué modelos incluye.
¿ChatGPT Plus incluye la API de OpenAI?
No. ChatGPT y la plataforma de la API tienen sistemas de facturación separados, y OpenAI lista el uso de la API como no incluido en Plus. Lo mismo aplica a los planes Go y Business.
¿Cuánto cuesta la API de OpenAI?
Depende del modelo. A octubre de 2026, GPT-6 Astra cuesta USD 10 por millón de tokens de entrada y USD 50 por millón de salida; GPT-6.1 Sol, USD 2 y USD 10; GPT-6 Luna, USD 0,10 y USD 0,50. Los modos Batch y Flex cuestan la mitad.
¿Cuál es la recarga mínima y cuándo vencen los créditos?
Según la ayuda de OpenAI, a octubre de 2026, la recarga mínima es de USD 5 y los créditos vencen un año después de comprados, sin opción de extender el plazo. La recarga automática viene activada por defecto al configurar el pago.
¿Cómo veo o recupero mi API key de OpenAI?
Las llaves se gestionan en Settings → Organization → API keys, dentro de platform.openai.com. Si no guardaste el valor o crees que se expuso, crea una llave nueva, cámbiala en tus aplicaciones y revoca la anterior. Revocar una llave surte efecto en segundos.
¿Cómo conecto la API de OpenAI con n8n u otra herramienta?
Con la misma llave: la herramienta la guarda como credencial y la usa en cada llamada. Crea una llave exclusiva para esa integración, dentro de un proyecto con su propio límite de gasto, para poder revocarla sin afectar lo demás.
¿Qué pasa si alguien ve mi API key?
Puede gastar tu saldo. Revócala de inmediato, crea una nueva y revisa el consumo en la sección de uso de la organización. Por eso conviene configurar un límite duro de gasto el mismo día que creas la llave.

Datos verificados el 17 de octubre de 2026 en la documentación oficial de OpenAI: quickstart, precios, niveles de uso y buenas prácticas. Recarga mínima, vencimiento y facturación separada de ChatGPT: ayuda de OpenAI · Revisión trimestral

¿Te sirvió? Esto llega cada semana

Guías como esta, casos y estrategias de IA para tu negocio. Gratis y directo al grano.

Más guías de API

Más
Hablemos en WhatsAppDiagnóstico