Repolode
orhanerday

orhanerday/open-ai

ストリーミングに対応し、実行時のサードパーティ依存がない、コミュニティメンテナンスのOpenAI REST API用PHPクライアント。

スター
2,361
フォーク
292
未解決の Issue
0
最終コミット
17 日前

これは何?

PHPアプリケーションからOpenAI REST APIを利用するためのライブラリです。チャット補完、Responses API、画像、埋め込み、音声、ファイル、ファインチューニング、モデレーション、ベクトルストア、バッチ、アップロード、Realtimeセッション、Webhook、組織の利用状況レポート向けに専用メソッドを提供します。リクエストにはPHP標準のcURL拡張とJSON拡張を使うため、PHP 7.4以降が必要ですが、ほかの実行時パッケージは不要です。

専用メソッドのないエンドポイントには、汎用のrequest()メソッドを使って、設定済みのAPIプレフィックス配下にJSONまたはmultipart形式のリクエストを送信できます。ストリーミング呼び出しでは、Server-Sent Eventsのチャンクがコールバックに渡されます。ベースURLとAPIバージョンを変更できるため、OpenAI互換プロバイダーも利用できます。プロキシ、タイムアウト、ヘッダー、cURLオプションも設定可能です。

レスポンス処理では、ステータス、ヘッダー、JSONデコード機能を備えたResponseオブジェクトを利用できます。また、HTTPエラー時の例外送出を任意で有効にでき、レート制限や一部のサーバーエラーに対して指数バックオフによる自動再試行も行えます。

主な機能

  • 01チャット、Responses、画像、埋め込み、音声、ファイル、ファインチューニング向けの専用メソッド
  • 02コールバックを通じて受け取れるストリーミングレスポンス
  • 03専用メソッドのないRESTエンドポイント向けの汎用request()メソッド
  • 04OpenAI互換プロバイダー向けに変更できるベースURLとAPIバージョン
  • 05レート制限や一部のサーバーエラーに対する自動再試行
  • 06Webhook署名の検証

ユースケース

  • Laravel、Symfony、CakePHPアプリケーションへのOpenAIのチャット機能や画像生成機能の追加
  • Server-Sent Eventsを使った、ブラウザーへのモデル出力のストリーミング
  • ベースURLを変更してPHPからOpenAI互換プロバイダーを呼び出す
  • 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 とは?
ストリーミングに対応し、実行時のサードパーティ依存がない、コミュニティメンテナンスのOpenAI REST API用PHPクライアント。 PHPアプリケーションからOpenAI REST APIを利用するためのライブラリです。チャット補完、Responses API、画像、埋め込み、音声、ファイル、ファインチューニング、モデレーション、ベクトルストア、バッチ、アップロード、Realtimeセッション、Webhook、組織の利用状況レポート向けに専用メソッドを提供します。リクエストにはPHP標準のcURL拡張とJSON拡張を使うため、PHP 7.4以降が必要ですが、ほかの実行時パッケージは不要です。
open-ai は無料で使えますか?ライセンスは?
open-ai は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
open-ai は今もメンテナンスされていますか?
活発にメンテナンス中。open-ai の最終コミットは 2026年10月21日 です。
open-ai は何に使えますか?
Laravel、Symfony、CakePHPアプリケーションへのOpenAIのチャット機能や画像生成機能の追加 Server-Sent Eventsを使った、ブラウザーへのモデル出力のストリーミング ベースURLを変更してPHPからOpenAI互換プロバイダーを呼び出す 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 をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト