12. Generating API KEY

 

Cómo Obtener y Configurar tu API Key de OpenAI

📚 Tema del Tutorial:

"Tu Llave Mágica para la IA: Cómo Obtener y Configurar una API Key de OpenAI Paso a Paso"

---

🎯 Objetivo de Aprendizaje

Al final de este tutorial entenderás:

• Qué es una API Key y por qué es importante

• Cómo crear una cuenta gratuita en OpenAI

• Dónde generar y gestionar tus claves API

• Cómo configurar la API Key en tu proyecto PHP

• Buenas prácticas de seguridad para manejar claves

---

🏰 Parte 1: ¿Qué es una API Key? - Tu "Llave del Reino" de OpenAI

La Analogía del Banco:

Imagina que OpenAI es como un banco muy seguro lleno de servicios de IA:

text

🏦 BANCO OPENAI (Servidores con IA)

├── 🏦 Caja fuerte: Modelos de IA (Whisper, GPT-4, etc.)

├── 🏧 Cajeros: Endpoints API (/v1/audio/transcriptions)

├── 🏛️ Sucursales: platform.openai.com

└️️ 🔐 CANDADO: Solo entra quien tenga llave válida

🗝️ TU API KEY = LLAVE DEL BANCO

├️️ 🔑 Formato: sk-abc123def456ghi789jkl

├️️ 👤 Identifica: Tu cuenta específica

├️️ 💳 Factura: Tu consumo de IA

├️️ 🚪 Permiso: Acceso a los servicios

└️️ ⚠️ PELIGRO: Si la pierdes, otros pueden usarla

¿Por qué Necesitas una API Key?

text

📱 TU APLICACIÓN (MyWhisper)

   ↓ "Quiero transcribir este audio"

🔑 API KEY (sk-...)

   ↓ (identificación + permiso)

🏢 OPENAI SERVER

   ↓ "✅ Usuario válido, procesando..."

📝 TEXTO TRANSCRITO

   ↓ (envía de vuelta)

📱 TU APLICACIÓN

   ↓ "🎉 ¡Aquí está la transcripción!"

Sin API Key: Tu aplicación estaría gritando "¡Déjame entrar!" frente a un banco cerrado.
Con API Key: Tienes la llave maestra para usar todos los servicios.

---

📝 Parte 2: Creando tu Cuenta en OpenAI - Paso a Paso Visual

Paso 1: Ir al Sitio Correcto

URL exacta: https://platform.openai.com

text

🌐 EN TU NAVEGADOR:

1. Escribe: platform.openai.com

2. Presiona: Enter

3. Deberías ver: Página de inicio de OpenAI

⚠️ CUIDADO CON IMITACIONES:

✅ platform.openai.com ← CORRECTO

❌ openai-platform.com ← FALSO

❌ open-ai.com ← FALSO

❌ chatgpt-free.com ← FALSO

Paso 2: Registro o Inicio de Sesión

text

👤 SI NO TIENES CUENTA:

1. Haz clic en: "Sign up" (Registrarse)

2. Elige: Con email, Google o Microsoft

3. Completa: Verificación de email

4. Confirma: Número de teléfono (seguridad)

🔐 SI YA TIENES CUENTA:

1. Haz clic en: "Log in" (Iniciar sesión)

2. Usa: Tus credenciales

3. Accede: Al dashboard principal

Paso 3: Navegando el Dashboard

Lo que verás después de iniciar sesión:

text

📊 DASHBOARD DE OPENAI

├── 💰 Usage: Tu consumo y créditos

├── 🔑 API keys: Tus llaves secretas

├── 📄 Documentation: Cómo usar las APIs

├── 🛠️ Playground: Probar modelos sin código

├── 👤 Tu Nombre: Esquina superior derecha

└️️ 🖼️ Tu Foto: Si subiste una

Ubicación clave: Mira siempre en la esquina superior derecha para ver tu perfil.

---

🔐 Parte 3: Generando tu Primera API Key - Proceso Detallado

Paso 4: Acceder a la Sección de API Keys

text

📍 RUTA EXACTA:

1. 👤 Haz clic en tu nombre/foto (esquina superior derecha)

2. 📋 Menú desplegable aparece

3. 🔑 Selecciona: "View API keys"

4. 🚀 Te redirige a: https://platform.openai.com/api-keys

Captura mental de la pantalla:

text

👤 [Tu Foto/Nombre]  ← Haz clic aquí

   ▼ (menú desplegable)

   ├── 🔑 View API keys  ← ¡ESTO!

   ├── 📄 Documentation

   ├── 🛠️ Playground

   ├── 💰 Usage

   └── 👤 Settings

Paso 5: Crear Nueva API Key

En la página de API Keys verás:

text

📋 PÁGINA DE API KEYS

├── 🎉 "Welcome to the OpenAI API!"

├── ➕ "Create new secret key" (botón)

├── 📋 Lista de keys existentes (si tienes)

└️️ ⚠️ Advertencias de seguridad

Proceso para crear key:

text

1. ➕ Haz clic en: "Create new secret key"

2. 📝 Ventana emergente aparece

3. 🏷️ Escribe nombre: "MyWhisper" (o el que quieras)

4. ✅ Haz clic en: "Create secret key"

5. 🎉 ¡KEY GENERADA! (solo se muestra UNA vez)

Paso 6: El Momento Crítico - ¡Copiar la Key!

⚠️ ATENCIÓN: ESTO ES IMPORTANTÍSIMO ⚠️

text

🔑 TU NUEVA API KEY (ejemplo):

sk-abc123def456ghi789jkl012mno345pqr678stu901vwx

📋 VENTANA EMERGENTE:

┌─────────────────────────────────────┐

│ ✅ Your new secret key              │

│                                     │

│ sk-abc...901vwx                     │

│                                     │

│ ⚠️ Make sure to copy your key now!  │

│    You won't be able to see it again│

│                                     │

│ [📋 Copy]       [✅ Done]           │

└─────────────────────────────────────┘

Acciones CRUCIALES en este momento:

1. 📋 Haz clic en "Copy" - Copia automáticamente al portapapeles

2. 📝 Pégalo en un editor de texto temporal (Bloc de notas, etc.)

3. ✅ Haz clic en "Done" - La ventana se cierra

4. 💾 Guarda en lugar seguro - Nunca en email público o chat

¿Por qué solo se muestra una vez?
Por seguridad. Así si alguien hackea tu cuenta, no puede ver keys antiguas.

---

💾 Parte 4: Estructura de una API Key de OpenAI

Anatomía de una API Key:

text

🔑 sk-abc123def456ghi789jkl012mno345pqr678stu901vwx

├── sk- → Prefijo (siempre empieza así)

├── abc123def456 → Identificador único

├── ghi789jkl012 → Parte aleatoria

├── mno345pqr678 → Más aleatoriedad

└── stu901vwx → Final único

📏 LONGITUD: Aproximadamente 51 caracteres

🎨 FORMATO: Letras minúsculas y números

🔤 CONTENIDO: Base64 encoding

Tipos de API Keys (basadas en prefijo):

text

🔑 sk-... → Secret Key (la más común)

🔑 pk-... → Publishable Key (para frontend)

🔑 ok-... → Organization Key (para empresas)

Para nuestro proyecto: Siempre usamos sk- (Secret Key).

---

🛠️ Parte 5: Configurando la API Key en Nuestro Proyecto PHP

El Archivo init.php - Nuestro "Centro de Configuración"

Ubicación: backend/init.php

Contenido actual de init.php:

php

<?php

require 'classes/DB.php';

require 'classes/Whisper.php';

$whisperObj = new Whisper;

?>

Paso 7: Añadir la Constante API_TOKEN

Código modificado de init.php:

php

<?php

// 🔐 CONSTANTE DE CONFIGURACIÓN

define('API_TOKEN', 'sk-abc123def456ghi789jkl012mno345pqr678stu901vwx');

// 📦 CARGAR CLASES

require 'classes/DB.php';

require 'classes/Whisper.php';

// 🏗️ CREAR OBJETO PRINCIPAL

$whisperObj = new Whisper;

?>

Explicación de define() - Creando una "Constante":

php

define('API_TOKEN', 'tu-key-aqui');

// └─┬──┘ └─┬─────┘

//   │      │

//   │      └─ 🔑 VALOR: Tu API Key real

//   │

//   └─ 🏷️ NOMBRE: API_TOKEN (en mayúsculas, convención)

¿Qué es una constante en PHP?

• 📌 Valor fijo - No puede cambiar después de definirse

• 🌍 Alcance global - Accesible desde cualquier archivo

• 🚀 Más rápido - Ligeramente más rápido que variables

• 🎯 Mejor práctica - Para configuraciones que no cambian

Comparación: Constante vs Variable

php

// ❌ Variable (puede cambiar accidentalmente)

$api_token = 'sk-abc123...';

$api_token = '';  // ¡Oops! Alguien la borró

// ✅ Constante (protegida contra cambios)

define('API_TOKEN', 'sk-abc123...');

API_TOKEN = '';  // ❌ Error: No puedes reasignar

---

📁 Parte 6: Organización Correcta de Archivos de Configuración

Mejor Práctica: Archivo de Configuración Separado

Para proyectos más grandes, crea config.php:

php

<?php

// 📁 backend/config.php

return [

    'openai' => [

        'api_key' => 'sk-abc123def456...',

        'organization' => 'org-...',  // Opcional

    ],

    'database' => [

        'host' => 'localhost',

        'name' => 'MyWhisper',

        'user' => 'root',

        'pass' => ''

    ],

    'app' => [

        'name' => 'MyWhisper',

        'version' => '1.0.0',

        'debug' => true  // false en producción

    ]

];

?>

Luego en init.php:

php

<?php

// Cargar configuración

$config = require 'config.php';

// Definir constantes desde configuración

define('API_TOKEN', $config['openai']['api_key']);

define('DB_HOST', $config['database']['host']);

// ... etc.

require 'classes/DB.php';

require 'classes/Whisper.php';

$whisperObj = new Whisper;

?>

Para Nuestro Proyecto (simple):

Nos quedamos con la constante directa en init.php por simplicidad.

---

🔒 Parte 7: Seguridad - Protegiendo tu API Key

¡NUNCA HAGAS ESTO! - Errores Comunes de Seguridad:

php

// ❌❌❌ PELIGRO: Key en código público

define('API_TOKEN', 'sk-abc123...');

// Si subes a GitHub, cualquiera puede usar tu key

// ❌❌ PELIGRO: Key en archivo accesible

// Archivo en: /public/config.php ← Cualquiera puede acceder

// ❌ PELIGRO: Key en comentarios

// define('API_TOKEN', 'sk-old-key'); // Key antigua: sk-abc...

// Los comentarios se ven en el código fuente

✅ BUENAS PRÁCTICAS de Seguridad:

1. Usar variables de entorno (MEJOR PRÁCTICA):

php

// .env file (NO subir a GitHub)

API_KEY=sk-abc123def456...

// PHP para leer .env

$apiKey = getenv('API_KEY');

define('API_TOKEN', $apiKey);

2. Archivo fuera del directorio web:

text

📁 proyecto/

├── 📁 public/ (accesible desde web)

│   └── index.php

├── 📁 backend/ (NO accesible desde web)

│   ├── config.php ← API Key aquí ✅

│   └── init.php

└── .env ← API Key aquí (MEJOR) ✅

3. Restringir permisos del archivo:

bash

# En Linux/Mac

chmod 600 config.php  # Solo dueño puede leer/escribir

4. Rotar keys periódicamente:

• Genera nueva key cada 3-6 meses

• Actualiza en tu aplicación

• Revoca la key antigua en OpenAI

---

🧪 Parte 8: Probando que la API Key Funciona

Prueba Simple con cURL:

Comando en terminal:

bash

curl https://api.openai.com/v1/models \

  -H "Authorization: Bearer sk-tu-key-aqui"

Respuesta exitosa (deberías ver):

json

{

  "object": "list",

  "data": [

    {"id": "whisper-1", "object": "model", ...},

    {"id": "gpt-3.5-turbo", "object": "model", ...},

    {"id": "gpt-4", "object": "model", ...}

  ]

}

Respuesta de error (key inválida):

json

{

  "error": {

    "message": "Incorrect API key provided",

    "type": "invalid_request_error",

    "param": null,

    "code": "invalid_api_key"

  }

}

Prueba en Nuestro Código:

Añadir en Whisper.php para probar:

php

public function testAPIKey(){

    $ch = curl_init('https://api.openai.com/v1/models');

    curl_setopt($ch, CURLOPT_HTTPHEADER, [

        'Authorization: Bearer ' . API_TOKEN

    ]);

    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    

    $response = curl_exec($ch);

    curl_close($ch);

    

    $data = json_decode($response, true);

    

    if(isset($data['error'])){

        echo "❌ Error: " . $data['error']['message'];

        return false;

    } else {

        echo "✅ API Key válida! Tienes acceso a: ";

        foreach($data['data'] as $model){

            echo $model['id'] . ", ";

        }

        return true;

    }

}

---

💰 Parte 9: Créditos Gratis y Precios

Créditos Iniciales Gratis:

Cuando creas cuenta nueva en OpenAI:

text

🎁 REGALO DE BIENVENIDA (varía por país):

├── 🌎 EE.UU./Canadá: $5-18 crédito gratis

├── 🌍 Europa: €10-15 crédito gratis

├── 🌏 Otros países: Varía, pero siempre algo

└️️ ⏰ Expiración: Generalmente 3 meses

🧮 ¿CUÁNTO RINDE?

Con $5 crédito gratis puedes:

├── 🎤 Transcribir: ~833 minutos de audio (13.8 horas)

├── 💬 Chatear con GPT: ~1,000,000 tokens

└️️ 🎨 Generar imágenes: ~100 imágenes

Precios de Whisper API:

text

💰 PRECIOS ACTUALES (verificar en plataforma):

Whisper transcription: $0.006 por minuto

📱 EJEMPLO DE CONSUMO:

├── 1 minuto audio: $0.006

├── 10 minutos: $0.06

├── 1 hora: $0.36

├── 10 horas: $3.60

└️️ 💡 Consejo: Los primeros $5 te dan ~13 horas gratis

Cómo Ver tu Uso y Límites:

text

📍 En platform.openai.com:

1. 👤 Tu perfil → "Usage"

2. 📊 Verás gráfico de consumo

3. ⚠️ Alertas: Te avisan al 80%, 90%, 100%

4. 💳 Añadir método de pago: Para continuar después de créditos

Configurar límites de gasto:

bash

# En platform.openai.com → Settings → Billing

# Puedes establecer límites mensuales como:

- $10/mes máximo

- $50/mes máximo

- Personalizado

---

🚨 Parte 10: Solución de Problemas Comunes

Problema 1: "Incorrect API key provided"

Posibles causas:

• 🔑 Key mal copiada (faltan caracteres)

• 📋 Espacios al inicio/final

• 🗑️ Key revocada o eliminada

• 🌍 Región bloqueada (algunos países)

Solución:

1. Generar nueva key

2. Copiar EXACTAMENTE sin espacios

3. Probar con cURL primero

4. Verificar que la cuenta esté activa

Problema 2: "You exceeded your current quota"

Causa: Se acabaron los créditos gratis
Solución: Añadir método de pago en Billing

Problema 3: La key desapareció de la lista

Causa: La copiaste y no la guardaste
Solución:

1. Generar NUEVA key (la antigua no se puede recuperar)

2. Guardarla inmediatamente esta vez

3. Actualizar en init.php

Problema 4: Error 429 "Too many requests"

Causa: Límite de tasa (rate limiting)
Solución: Esperar 1 minuto o implementar retry en código

---

🧩 Parte 11: Ejercicio Práctico - Gestión de Múltiples Keys

Ejercicio 1: Sistema de Keys por Entorno

config.php avanzado:

php

<?php

// Diferentes keys para desarrollo y producción

$environments = [

    'development' => [

        'api_key' => 'sk-dev-key-123...',

        'base_url' => 'https://api.openai.com',

        'log_level' => 'debug'

    ],

    'production' => [

        'api_key' => 'sk-prod-key-456...',

        'base_url' => 'https://api.openai.com',

        'log_level' => 'error'

    ]

];

// Determinar entorno automáticamente

if ($_SERVER['HTTP_HOST'] === 'localhost') {

    $currentEnv = 'development';

} else {

    $currentEnv = 'production';

}

// Cargar configuración del entorno actual

$config = $environments[$currentEnv];

define('API_TOKEN', $config['api_key']);

?>

Ejercicio 2: Rotación Automática de Keys

php

class APIKeyManager {

    private $keys = [

        'primary' => 'sk-key-1...',

        'secondary' => 'sk-key-2...',

        'backup' => 'sk-key-3...'

    ];

    

    public function getKey() {

        // Rotar keys si una falla

        static $attempts = 0;

        $keyNames = array_keys($this->keys);

        $currentKey = $keyNames[$attempts % count($keyNames)];

        

        return $this->keys[$currentKey];

    }

    

    public function reportFailure($keyUsed) {

        // Lógica para marcar key como problemática

        error_log("Key $keyUsed falló, considerando rotación");

    }

}

---

📊 Parte 12: Resumen Visual del Proceso

Diagrama de Flujo Completo:

text

[1️⃣ platform.openai.com]

        ↓ (crear cuenta/iniciar sesión)

[2️⃣ Dashboard OpenAI]

        ↓ (clic en perfil → API keys)

[3️⃣ Página API Keys]

        ↓ (Create new secret key)

[4️⃣ Ventana emergente]

        ↓ (copiar key → pegar en lugar seguro)

[5️⃣ Archivo init.php]

        ↓ (define('API_TOKEN', 'sk-...'))

[6️⃣ Clase Whisper.php]

        ↓ (usa API_TOKEN para autenticar)

[7️⃣ OpenAI API]

        ↓ (verifica key → procesa solicitud)

[8️⃣ Tu aplicación]

        ↓ (recibe respuesta de IA)

Checklist de Seguridad API Key:

✅ Generada en platform.openai.com oficial
✅ Copiada inmediatamente al crearse
✅ Guardada en lugar seguro (no en email/chat)
✅ Configurada como constante en PHP
✅ Archivo protegido fuera de web root (ideal)
✅ NO compartida con nadie
✅ Monitorizado el uso en dashboard
✅ Plan de rotación cada 3-6 meses

---

❓ Parte 13: Cuestionario de Evaluación

Pregunta 1:

¿Dónde se genera una API Key de OpenAI?
a) En chat.openai.com
b) En platform.openai.com ✅
c) En github.com/openai
d) En la app móvil de ChatGPT

Explicación: platform.openai.com es el portal para desarrolladores.

Pregunta 2:

¿Cuántas veces puedes ver tu API Key completa después de generarla?
a) Una sola vez ✅
b) Siempre que quieras
c) 3 veces máximo
d) 10 veces máximo

Pregunta 3:

¿Qué función de PHP usamos para definir la API Key como constante?
a) $api_key = 'sk-...'
b) const API_KEY = 'sk-...'
c) define('API_TOKEN', 'sk-...') ✅
d) set('API_TOKEN', 'sk-...')

Pregunta 4:

¿Por qué es peligroso subir tu API Key a GitHub?
a) Porque GitHub la borra
b) Porque otros pueden usarla y gastar tu crédito ✅
c) Porque OpenAI la bloquea automáticamente
d) Porque GitHub la encripta mal

Pregunta 5:

¿Cuál es el formato típico de una API Key de OpenAI?
a) Empieza con api-
b) Empieza con sk- ✅
c) Empieza con key-
d) Empieza con openai-

---

Pregunta 6:

¿Qué deberías hacer inmediatamente después de generar una nueva API Key?
a) Compartirla con tu equipo
b) Copiarla y guardarla en lugar seguro ✅
c) Probarla en producción
d) Hacerle una captura de pantalla

Pregunta 7:

¿Dónde es MEJOR guardar la API Key en un proyecto profesional?
a) Directamente en init.php
b) En variables de entorno (.env) ✅
c) En un comentario del código
d) En la base de datos

Respuesta correcta: b) Variables de entorno (.env) fuera del control de versiones.

---

🏆 Resumen Final - Guía Rápida de API Key

Los 5 Pasos Esenciales:

1. 📍 platform.openai.com → Inicia sesión/regístrate

2. 👤 Tu perfil → "View API keys"

3. ➕ Create new secret key → Nómbrala "MyWhisper"

4. 📋 Copia INMEDIATAMENTE → Pega en lugar seguro

5. 🔧 init.php → define('API_TOKEN', 'sk-tu-key-aqui');

Las 4 Reglas de Oro de Seguridad:

1. 🔐 Nunca en código público (GitHub, etc.)

2. 💾 Guarda en .env o fuera de web root

3. 🔄 Rota cada 3-6 meses

4. 👁️ Monitoriza uso en dashboard

Recursos Importantes:

• 📊 Dashboard uso: platform.openai.com/usage

• 🔑 Gestión keys: platform.openai.com/api-keys

• 📚 Documentación: platform.openai.com/docs

• 💳 Facturación: platform.openai.com/billing

💰 Recuerda: Los primeros $5-18 son GRATIS para que pruebes.

---

🚀 Próximos Pasos - Lo que Viene

Listo para la Siguiente Lección:

Ahora que tienes tu API Key, en la próxima lección:

1. 🔧 Configuraremos la clase Whisper completa

2. 📤 Enviaremos archivos de audio a la API

3. 📝 Recibiremos transcripciones de vuelta

4. 💾 Guardaremos resultados en base de datos

Código que Usaremos Pronto:

php

// Usando tu API Key recién configurada

public function sendToWhisperAPI($audioFile){

    $ch = curl_init('https://api.openai.com/v1/audio/transcriptions');

    curl_setopt($ch, CURLOPT_HTTPHEADER, [

        'Authorization: Bearer ' . API_TOKEN,  // ← ¡TU KEY AQUÍ!

        'Content-Type: multipart/form-data'

    ]);

    // ... resto del código

}

🎉 ¡Felicidades! Acabas de obtener la "llave mágica" que desbloquea el poder de la IA de OpenAI para tu aplicación. Con esta pequeña cadena de texto, puedes acceder a tecnología que costó millones desarrollar y años de investigación.

---

💡 Reflexión Final:
Hace unos años, tecnología como Whisper solo estaba disponible para gigantes como Google o Amazon, con costos prohibitivos. Hoy, con una API Key gratuita y unos centavos por minuto, cualquier desarrollador puede integrar transcripción de voz de nivel mundial en sus aplicaciones. ¡Estás en la era dorada del desarrollo con IA!

🔑 ¡Tu API Key está lista y configurada! Ahora podemos hacer que Whisper AI trabaje para nosotros