Repolode
orhanerday

orhanerday/open-ai

Поддерживаемый сообществом PHP-клиент для OpenAI REST API с поддержкой потоковой передачи и без сторонних зависимостей во время выполнения.

Звёзды
2,361
Форки
292
Открытые issues
0
Последний коммит
17 дней назад

Что это?

Библиотека предоставляет PHP-приложениям интерфейс для работы с OpenAI REST API. В ней есть отдельные методы для chat completions, Responses API, изображений, эмбеддингов, аудио, файлов, тонкой настройки, модерации, векторных хранилищ, пакетных запросов, загрузок, realtime-сессий, вебхуков и отчетов об использовании организации. Запросы выполняются с помощью встроенных в PHP расширений cURL и JSON, поэтому требуется PHP 7.4 или новее, а другие пакеты во время выполнения не нужны.

Для эндпоинтов без отдельного метода общий метод request() отправляет запросы с настроенным префиксом API и телом в формате JSON или multipart. При потоковой передаче фрагменты server-sent events передаются в callback. Можно изменить базовый URL и версию API, чтобы использовать совместимые с OpenAI провайдеры. Также доступны настройки прокси, таймаута, заголовков и параметров cURL.

Для обработки ответов предусмотрен объект Response со статусом, заголовками и декодированием JSON, возможность включить исключения для HTTP-ошибок, а также автоматические повторы с экспоненциальной задержкой при ограничении частоты запросов и некоторых ошибках сервера.

Ключевые возможности

  • 01Отдельные методы для chat, Responses, изображений, эмбеддингов, аудио, файлов и тонкой настройки
  • 02Потоковые ответы передаются через callback
  • 03Общий метод request() для REST-эндпоинтов без отдельных методов
  • 04Настраиваемые базовый URL и версия API для совместимых с OpenAI провайдеров
  • 05Автоматические повторы при ограничении частоты запросов и некоторых ошибках сервера
  • 06Проверка подписи вебхуков

Сценарии использования

  • Добавление чата OpenAI или генерации изображений в приложение на Laravel, Symfony или CakePHP
  • Потоковая передача вывода модели в браузер через server-sent events
  • Вызов совместимых с OpenAI провайдеров из PHP с помощью изменения базового URL
  • Управление файлами, пакетными запросами или векторными хранилищами из PHP-скриптов для внутренних задач

Быстрый старт

  1. 1

    Установите библиотеку с помощью Composer

    composer require orhanerday/open-ai
  2. 2

    Задайте переменную окружения OPENAI_API_KEY (Linux или macOS)

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

    Сохраните пример из README в файл example.php и запустите его

    php example.php

Что важно знать

  • Предупреждение о безопасности среды выполнения PHP: CVE-2026-109618 и CVE-2026-109619 затрагивают сам PHP, поэтому перед использованием обновите PHP.
  • Режим WebSocket и управление ходом диалога в процессе его выполнения не поддерживаются; требуется отдельный клиент.

В подборках

Темы

Частые вопросы

Что такое open-ai?
Поддерживаемый сообществом PHP-клиент для OpenAI REST API с поддержкой потоковой передачи и без сторонних зависимостей во время выполнения. Библиотека предоставляет PHP-приложениям интерфейс для работы с OpenAI REST API. В ней есть отдельные методы для chat completions, Responses API, изображений, эмбеддингов, аудио, файлов, тонкой настройки, модерации, векторных хранилищ, пакетных запросов, загрузок, realtime-сессий, вебхуков и отчетов об использовании организации. Запросы выполняются с помощью встроенных в PHP расширений cURL и JSON, поэтому требуется PHP 7.4 или новее, а другие пакеты во время выполнения не нужны.
open-ai можно использовать бесплатно? Какая у него лицензия?
open-ai распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
open-ai всё ещё поддерживается?
Активно поддерживается. Последний коммит в open-ai — 21 окт. 2026 г..
Для чего можно использовать open-ai?
Добавление чата OpenAI или генерации изображений в приложение на Laravel, Symfony или CakePHP Потоковая передача вывода модели в браузер через server-sent events Вызов совместимых с OpenAI провайдеров из PHP с помощью изменения базового URL Управление файлами, пакетными запросами или векторными хранилищами из PHP-скриптов для внутренних задач
Как установить open-ai?
Установите библиотеку с помощью Composer: composer require orhanerday/open-ai Задайте переменную окружения OPENAI_API_KEY (Linux или macOS): export OPENAI_API_KEY='your-api-key' Сохраните пример из README в файл example.php и запустите его: php example.php
Где скачать open-ai?
Исходный код и инструкции по установке — на GitHub: https://github.com/orhanerday/open-ai

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты