google-gemini-php/client

어떤 프로젝트인가요?

핵심 기능

• 01텍스트, 이미지, 동영상, 오디오, 문서 입력을 지원합니다.
• 02스트리밍 응답과 멀티턴 채팅 세션을 제공합니다.
• 03스키마 또는 JSON Schema 배열을 사용해 구조화된 JSON 출력을 반환합니다.
• 04함수 호출과 Google Search, 코드 실행 같은 내장 도구를 포함합니다.
• 05파일 업로드, 컨텍스트 캐싱, File Search 스토어를 지원합니다.
• 06테스트용 가짜 클라이언트를 제공합니다.

활용 사례

• Laravel 또는 기타 PHP 백엔드에 Gemini 기반 채팅이나 콘텐츠 생성을 추가할 수 있습니다.
• 문서나 이미지에서 구조화된 데이터를 추출해 타입이 지정된 JSON으로 만들 수 있습니다.
• File Search로 업로드한 문서를 대상으로 검색 증강 답변을 구축할 수 있습니다.
• 실제 API를 호출하지 않고 Gemini를 사용하는 PHP 코드의 단위 테스트를 작성할 수 있습니다.

빠른 시작

1. 1

   Composer로 PHP 8.2 이상 패키지를 설치합니다

   composer require google-gemini-php/client
2. 2

   프로젝트에 PSR-18 HTTP 클라이언트가 없다면 설치합니다

   composer require guzzlehttp/guzzle
3. 3

   Google AI Studio에서 Gemini API 키를 만듭니다

4. 4

   API 키로 클라이언트를 만들고 gemini-2.5-flash에서 generateContent를 호출합니다

사용 전 알아둘 점

• !PHP 8.2 이상이 필요합니다.
• !Google AI Studio에서 발급한 Gemini API 키가 필요합니다.
• !버전 2.0은 Gemini v1beta API에서만 작동합니다.

토픽

자주 묻는 질문

client은(는) 무엇인가요?

텍스트, 미디어, 스트리밍, 도구, 파일 및 캐시 관리를 지원하는 커뮤니티 관리형 Gemini API용 PHP 클라이언트입니다. Gemini PHP는 Google Gemini API용 커뮤니티 관리형 PHP API 클라이언트입니다. PHP 애플리케이션에서 텍스트, 이미지, 동영상, 오디오, 문서를 Gemini 모델에 입력할 수 있으며, 스트리밍, 멀티턴 채팅, 구조화된 JSON 출력, 함수 호출을 지원합니다.

client은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

client은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

client은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. client의 마지막 커밋은 2026년 10월 12일입니다.

client은(는) 어디에 사용할 수 있나요?

Laravel 또는 기타 PHP 백엔드에 Gemini 기반 채팅이나 콘텐츠 생성을 추가할 수 있습니다. 문서나 이미지에서 구조화된 데이터를 추출해 타입이 지정된 JSON으로 만들 수 있습니다. File Search로 업로드한 문서를 대상으로 검색 증강 답변을 구축할 수 있습니다. 실제 API를 호출하지 않고 Gemini를 사용하는 PHP 코드의 단위 테스트를 작성할 수 있습니다.

client는 어떻게 설치하나요?

Composer로 PHP 8.2 이상 패키지를 설치합니다: composer require google-gemini-php/client 프로젝트에 PSR-18 HTTP 클라이언트가 없다면 설치합니다: composer require guzzlehttp/guzzle Google AI Studio에서 Gemini API 키를 만듭니다 API 키로 클라이언트를 만들고 gemini-2.5-flash에서 generateContent를 호출합니다

client은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/google-gemini-php/client