Repolode
orhanerday

orhanerday/open-ai

스트리밍을 지원하고 서드파티 런타임 의존성이 없는 커뮤니티 유지보수 PHP용 OpenAI REST API 클라이언트입니다.

스타
2,361
포크
292
열린 이슈
0
마지막 커밋
17일 전

어떤 프로젝트인가요?

이 라이브러리는 PHP 애플리케이션에서 OpenAI REST API를 사용할 수 있도록 래핑합니다. chat completions, Responses API, 이미지, 임베딩, 오디오, 파일, fine-tuning, moderation, vector stores, batches, 업로드, realtime 세션, 웹훅, 조직 사용량 보고를 위한 전용 메서드를 제공합니다. 요청에는 PHP 기본 cURL 및 JSON 확장을 사용하므로 PHP 7.4 이상이 필요하며, 그 밖의 런타임 패키지는 필요하지 않습니다.

전용 메서드가 없는 엔드포인트에는 일반 request() 메서드를 사용해 설정된 API prefix 아래로 JSON 또는 multipart 본문을 포함한 요청을 보낼 수 있습니다. 스트리밍 호출은 서버 전송 이벤트 청크를 콜백으로 전달합니다. 기본 URL과 API 버전을 변경할 수 있어 OpenAI 호환 제공업체에도 사용할 수 있습니다. 프록시, 타임아웃, 헤더, cURL 옵션도 설정할 수 있습니다.

응답 처리는 상태 코드, 헤더, JSON 디코딩을 지원하는 Response 객체를 제공합니다. HTTP 오류 시 예외를 선택적으로 발생시킬 수 있으며, rate limit과 일부 서버 오류에 대해서는 지수 백오프를 적용해 자동으로 재시도합니다.

핵심 기능

  • 01chat, Responses, 이미지, 임베딩, 오디오, 파일, fine-tuning을 위한 전용 메서드
  • 02콜백을 통해 전달되는 스트리밍 응답
  • 03전용 메서드가 없는 REST 엔드포인트를 위한 일반 request() 메서드
  • 04OpenAI 호환 제공업체를 위한 기본 URL 및 API 버전 설정
  • 05rate limit과 일부 서버 오류에 대한 자동 재시도
  • 06웹훅 서명 검증

활용 사례

  • Laravel, Symfony 또는 CakePHP 애플리케이션에 OpenAI 채팅이나 이미지 생성을 추가
  • 서버 전송 이벤트를 통해 브라우저에 모델 출력을 스트리밍
  • 기본 URL을 변경해 PHP에서 OpenAI 호환 제공업체 호출
  • PHP 백오피스 스크립트에서 파일, 배치 또는 vector stores 관리

빠른 시작

  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, 이미지, 임베딩, 오디오, 파일, fine-tuning, moderation, vector stores, batches, 업로드, realtime 세션, 웹훅, 조직 사용량 보고를 위한 전용 메서드를 제공합니다. 요청에는 PHP 기본 cURL 및 JSON 확장을 사용하므로 PHP 7.4 이상이 필요하며, 그 밖의 런타임 패키지는 필요하지 않습니다.
open-ai은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
open-ai은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
open-ai은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. open-ai의 마지막 커밋은 2026년 10월 21일입니다.
open-ai은(는) 어디에 사용할 수 있나요?
Laravel, Symfony 또는 CakePHP 애플리케이션에 OpenAI 채팅이나 이미지 생성을 추가 서버 전송 이벤트를 통해 브라우저에 모델 출력을 스트리밍 기본 URL을 변경해 PHP에서 OpenAI 호환 제공업체 호출 PHP 백오피스 스크립트에서 파일, 배치 또는 vector stores 관리
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 통계는 매일 갱신됩니다.

관련 프로젝트