Repolode
Enviar
orhanerday

orhanerday/open-ai

Cliente PHP mantenido por la comunidad para la API REST de OpenAI, con soporte para streaming y sin dependencias de terceros en tiempo de ejecución.

Ver en GitHub
Estrellas
2,361
Forks
292
Issues abiertos
0
Último commit
hace 17 días

¿Qué es?

Esta biblioteca integra la API REST de OpenAI en aplicaciones PHP. Ofrece métodos específicos para chat completions, la Responses API, imágenes, embeddings, audio, archivos, fine-tuning, moderación, vector stores, lotes, cargas, sesiones en tiempo real, webhooks e informes de uso de la organización. Las solicitudes utilizan las extensiones cURL y JSON nativas de PHP, por lo que requiere PHP 7.4 o posterior y no necesita otros paquetes en tiempo de ejecución.

Para los endpoints que no cuentan con un método específico, un método genérico request() envía llamadas bajo el prefijo de API configurado, con cuerpos JSON o multipart. Las llamadas en streaming envían fragmentos de eventos enviados por el servidor a una función callback. Se pueden cambiar la URL base y la versión de la API, lo que permite usar proveedores compatibles con OpenAI. También se pueden configurar el proxy, el tiempo de espera, los encabezados y las opciones de cURL.

La gestión de respuestas incluye un objeto Response con el estado, los encabezados y la decodificación de JSON; excepciones opcionales para errores HTTP; y reintentos automáticos con espera exponencial para límites de solicitudes y determinados errores del servidor.

Funciones clave

  • 01Métodos específicos para chat, Responses, imágenes, embeddings, audio, archivos y fine-tuning
  • 02Respuestas en streaming enviadas mediante una función callback
  • 03Método genérico request() para endpoints REST sin métodos específicos
  • 04URL base y versión de la API configurables para proveedores compatibles con OpenAI
  • 05Reintentos automáticos para límites de solicitudes y determinados errores del servidor
  • 06Verificación de firmas de webhooks

Casos de uso

  • Añadir chat de OpenAI o generación de imágenes a una aplicación Laravel, Symfony o CakePHP
  • Enviar en streaming la salida del modelo a un navegador mediante eventos enviados por el servidor
  • Llamar a proveedores compatibles con OpenAI desde PHP cambiando la URL base
  • Gestionar archivos, lotes o vector stores desde scripts PHP de administración

Inicio rápido

  1. 1

    Instala la biblioteca con Composer

    composer require orhanerday/open-ai
  2. 2

    Configura la variable de entorno OPENAI_API_KEY (Linux o macOS)

    export OPENAI_API_KEY='your-api-key'
  3. 3

    Guarda el ejemplo del README como example.php y ejecútalo

    php example.php

Antes de usarlo

  • Aviso de seguridad del runtime de PHP: CVE-2026-109618 y CVE-2026-109619 afectan al propio PHP, así que actualiza PHP antes de usarlo.
  • No se admiten el modo WebSocket ni la dirección de la conversación durante un turno; se necesita un cliente independiente.

En colecciones

Herramientas de streaming

Temas

#openai#php#llm#api-client#streaming#sdk#cakephp#dall-e#dalle2#gpt-3

Preguntas frecuentes

¿Qué es open-ai?
Cliente PHP mantenido por la comunidad para la API REST de OpenAI, con soporte para streaming y sin dependencias de terceros en tiempo de ejecución. Esta biblioteca integra la API REST de OpenAI en aplicaciones PHP. Ofrece métodos específicos para chat completions, la Responses API, imágenes, embeddings, audio, archivos, fine-tuning, moderación, vector stores, lotes, cargas, sesiones en tiempo real, webhooks e informes de uso de la organización. Las solicitudes utilizan las extensiones cURL y JSON nativas de PHP, por lo que requiere PHP 7.4 o posterior y no necesita otros paquetes en tiempo de ejecución.
¿open-ai es gratuito? ¿Qué licencia tiene?
open-ai es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿open-ai sigue mantenido?
Mantenimiento activo. El último commit de open-ai fue el 21 oct 2026.
¿Para qué puedo usar open-ai?
Añadir chat de OpenAI o generación de imágenes a una aplicación Laravel, Symfony o CakePHP Enviar en streaming la salida del modelo a un navegador mediante eventos enviados por el servidor Llamar a proveedores compatibles con OpenAI desde PHP cambiando la URL base Gestionar archivos, lotes o vector stores desde scripts PHP de administración
¿Cómo se instala open-ai?
Instala la biblioteca con Composer: composer require orhanerday/open-ai Configura la variable de entorno OPENAI_API_KEY (Linux o macOS): export OPENAI_API_KEY='your-api-key' Guarda el ejemplo del README como example.php y ejecútalo: php example.php
¿Dónde consigo open-ai?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/orhanerday/open-ai

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados