Conectar PHP con OpenAI te permite llevar un sistema local a un modelo profesional en la nube usando un componente de Composer y un API key válido. Es ideal si ya trabajaste con modelos locales y quieres dar el salto a respuestas más potentes desde tu terminal.
Qué necesitas para integrar PHP con OpenAI
La integración parte de buscar el componente oficial recomendado para PHP, instalarlo vía Composer y autenticarte con una clave secreta. Todo lo demás es replicar el patrón que ya conoces de los modelos locales.
¿Qué es un API key de OpenAI? Es una clave secreta que identifica tu cuenta de desarrollo y autoriza las llamadas al servicio. Sin ella, cualquier petición devuelve error de autenticación.
La investigación inicial del componente aparece alrededor de [00:08], donde se revisa el README y se confirma que es el paquete más usado para conectar PHP con esta tecnología.
Cómo instalar el cliente de OpenAI con Composer
Desde tu terminal pegas el comando que indica la documentación y sigues el asistente. Composer te pregunta si quieres habilitar configuración adicional en el archivo composer.json, y la respuesta es sí: ese permiso es requisito para que el paquete funcione.
El proceso de instalación se muestra cerca de [00:55], cuando se actualiza el proyecto y se aceptan los plugins necesarios.
Cómo se estructura el código en PHP
La lógica replica el patrón del modelo local, pero cambia la clase y el modelo. Estos son los pasos mínimos:
- Importar la clase
OpenAI según indica la documentación.
- Crear el cliente pasando tu API key como argumento.
- Llamar al método
chat y luego a create con el modelo elegido.
- Leer la respuesta desde el arreglo, accediendo a la posición cero, al mensaje y al contenido.
La explicación del flujo chat y create aparece alrededor de [02:30], donde se elige gpt-3.5 como primer modelo de prueba.
Cómo obtener un API key válido en OpenAI
Aquí está la diferencia clave entre usar ChatGPT como usuario final y usar la plataforma de desarrollo. Toda herramienta de inteligencia artificial profesional separa el chat de consumo de su capa para desarrolladores, y OpenAI no es la excepción.
Para crear tu clave necesitas registrarte en la plataforma oficial de desarrollo, ir a configuración y entrar a la sección de API keys. Antes de generar la primera clave, OpenAI te pide al menos un pago de cinco dólares para habilitar el saldo de la cuenta.
¿Por qué OpenAI cobra por usar la API? Porque cada petición consume tokens reales del modelo. El balance que cargas se descuenta según la cantidad de información procesada en cada llamada.
El recorrido por el panel de configuración y la creación de la clave Demo se ve alrededor de [04:20]. Recuerda que OpenAI no muestra la clave dos veces: cópiala apenas se genera.
Por qué no debes pegar la clave directamente en el código
Colocar el API key dentro del archivo PHP funciona para esta práctica, pero no es seguro. Una contraseña o un código secreto expuesto en el código fuente puede filtrarse al subir el repositorio. Más adelante esto se mejora con variables de entorno, aunque para fines didácticos basta con reemplazar el valor falso por el real y ejecutar la consulta.
Qué modelo de OpenAI conviene elegir
La decisión depende de dos variables: velocidad y costo. La documentación oficial lista todos los modelos disponibles y cada uno indica su rendimiento y precio.
- gpt-3.5: rápido y antiguo, útil para aprovechar saldo y practicar.
- gpt-4o: más potente, maneja mucha más información, respuesta más lenta.
- gpt-4o-mini: la recomendación oficial cuando buscas equilibrio entre costo y calidad.
La comparación entre gpt-3.5 y gpt-4o-mini aparece cerca de [06:10], donde se ejecuta la misma pregunta qué es PHP en ambos modelos para notar la diferencia de tiempo y profundidad en la respuesta.
Cómo monitorear tu consumo de tokens
Dentro del panel de configuración de OpenAI puedes revisar tu balance restante y el historial de uso. Ahí ves la cantidad de tokens consumidos por cada petición, qué modelo los gastó y cómo se distribuyó el saldo a lo largo del tiempo. Es la mejor forma de saber si tu sistema está siendo eficiente o si conviene migrar a un modelo más económico.
¿Qué es un token en OpenAI? Es la unidad mínima de texto que el modelo procesa, aproximadamente equivalente a una sílaba o fragmento de palabra. Cada petición y cada respuesta se cobran por la cantidad total de tokens involucrados.
Con esto tu sistema PHP ya conversa con un modelo profesional en la nube. El reto: replica el ejercicio en tu propio proyecto y comparte en los comentarios qué modelo elegiste y por qué.
