Client Laravel Package

Highlights

• PHP 8.2+ is now required. Projects on PHP 8.1 will keep resolving to 2.7.x.
• New API features: JSON Schema for structured output and function declarations, multimodal function responses, server-side tool invocations, per-part media resolution, ImageConfig::$imageSize, response metadata (responseId, modelStatus, finishMessage, urlContextMetadata, serviceTier), and importFile() / getOperation() for file search stores.
• ClientFake now supports startChat(), including multi-turn and streamed chats.
• The README has been refreshed with current models and examples for all features.

Behavior changes

No public signatures changed, but a few behaviors did:

• Streamed requests that fail with a 5xx and a JSON error body now throw ErrorException instead of TransporterException, like regular requests (#187).
• The chat history built by streamSendMessage() keeps thoughts, function calls and tool calls as separate parts and keeps their thoughtSignature. This fixes the next turn being rejected after a streamed function call, but $chat->history[$i]->parts may look different than before (#183).
• The ValueError messages of text() and parts() now end with the finish or block reason (#189).

What's Changed

Features

• Add new FinishReason, HarmCategory and MimeType values by @aydinfatih in https://github.com/google-gemini-php/client/pull/178
• Add response metadata fields by @aydinfatih in https://github.com/google-gemini-php/client/pull/179
• Add imageSize to ImageConfig by @aydinfatih in https://github.com/google-gemini-php/client/pull/180
• Support multimodal function responses by @aydinfatih in https://github.com/google-gemini-php/client/pull/181
• Support JSON Schema for structured output and function declarations by @aydinfatih in https://github.com/google-gemini-php/client/pull/182
• Support server-side tool invocations by @aydinfatih in https://github.com/google-gemini-php/client/pull/183
• Add media resolution per part by @aydinfatih in https://github.com/google-gemini-php/client/pull/184
• Add importFile and getOperation to file search stores by @aydinfatih in https://github.com/google-gemini-php/client/pull/185

Fixes

• Detect API errors returned wrapped in a list by @aydinfatih in https://github.com/google-gemini-php/client/pull/176
• Accept file names with the files/ prefix by @aydinfatih in https://github.com/google-gemini-php/client/pull/186
• Throw ErrorException for server errors on streamed requests by @aydinfatih in https://github.com/google-gemini-php/client/pull/187
• Support startChat() on ClientFake by @aydinfatih in https://github.com/google-gemini-php/client/pull/188
• Include finish and block reasons in quick accessor errors by @aydinfatih in https://github.com/google-gemini-php/client/pull/189
• Serialize the token id of logprobs candidates by @aydinfatih in https://github.com/google-gemini-php/client/pull/190
• Accept usage metadata without a total token count by @aydinfatih in https://github.com/google-gemini-php/client/pull/191

Maintenance

• Drop PHP 8.1 support and fix CI by @aydinfatih in https://github.com/google-gemini-php/client/pull/177
• Refresh the README by @aydinfatih in https://github.com/google-gemini-php/client/pull/192

Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.4...2.8.0

What's Changed

• Make thinkingBudget optional in ThinkingConfig by @foremtehan in https://github.com/google-gemini-php/client/pull/162
• Feat: Add File Search API and Google Maps Tool SupportFeature/new gemini tools by @jfradj in https://github.com/google-gemini-php/client/pull/164

New Contributors

• @jfradj made their first contribution in https://github.com/google-gemini-php/client/pull/164

Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.3...2.7.4

What's Changed

• Add ThinkingLevel enum by @foremtehan in https://github.com/google-gemini-php/client/pull/161

New Contributors

• @foremtehan made their first contribution in https://github.com/google-gemini-php/client/pull/161

Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.2...2.7.3

What's Changed

• feat: Add Interval class with RFC 3339 validation and GoogleSearch time filtering by @millyhung in https://github.com/google-gemini-php/client/pull/158

New Contributors

• @millyhung made their first contribution in https://github.com/google-gemini-php/client/pull/158

Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.1...2.7.2

What's Changed

• Bug fix by @aydinfatih in https://github.com/google-gemini-php/client/pull/152
• Update README by @aydinfatih in https://github.com/google-gemini-php/client/pull/154
• feat: Remove unused PHPDoc and import statements for cleanup by @aydinfatih in https://github.com/google-gemini-php/client/pull/155

Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.0...2.7.1

What's Changed

• Add ImageConfig to GenerationConfig and add new FinishReason types. by @shaxaaa in https://github.com/google-gemini-php/client/pull/145

New Contributors

• @shaxaaa made their first contribution in https://github.com/google-gemini-php/client/pull/145

Full Changelog: https://github.com/google-gemini-php/client/compare/2.6.0...2.7.0

What's Changed

• Fix: Clarify HTTP client variable in factory example by @rema424 in https://github.com/google-gemini-php/client/pull/132
• Update FinishReason.php with new finish reasons by @jibran in https://github.com/google-gemini-php/client/pull/137
• implement context caching by @michabbb in https://github.com/google-gemini-php/client/pull/135

New Contributors

• @rema424 made their first contribution in https://github.com/google-gemini-php/client/pull/132
• @jibran made their first contribution in https://github.com/google-gemini-php/client/pull/137
• @michabbb made their first contribution in https://github.com/google-gemini-php/client/pull/135

Full Changelog: https://github.com/google-gemini-php/client/compare/2.5.0...2.6.0

What's Changed

• Added thoughts bool to indicate thoughts by @Plytas in https://github.com/google-gemini-php/client/pull/131

Full Changelog: https://github.com/google-gemini-php/client/compare/2.4.0...2.5.0

What's Changed

• Added urlContext support by @Plytas in https://github.com/google-gemini-php/client/pull/128

Full Changelog: https://github.com/google-gemini-php/client/compare/2.3.1...2.4.0

What's Changed

• Add Type for UploadedFile by @rodnaph in https://github.com/google-gemini-php/client/pull/123
• Add FilesContract to Client by @rodnaph in https://github.com/google-gemini-php/client/pull/124
• Added documentation for speech generation by @Plytas in https://github.com/google-gemini-php/client/pull/125

New Contributors

• @rodnaph made their first contribution in https://github.com/google-gemini-php/client/pull/123

Full Changelog: https://github.com/google-gemini-php/client/compare/2.3.0...2.3.1

What's Changed

• Fix readme code examples by @Plytas in https://github.com/google-gemini-php/client/pull/117
• citationSources attribute can be unset by @maximetassy in https://github.com/google-gemini-php/client/pull/119
• Added TTS support by @Plytas in https://github.com/google-gemini-php/client/pull/121

Full Changelog: https://github.com/google-gemini-php/client/compare/2.2.0...2.3.0

What's Changed

• Add List and Delete methods to Files API by @khartnett in https://github.com/google-gemini-php/client/pull/114

New Contributors

• @khartnett made their first contribution in https://github.com/google-gemini-php/client/pull/114

Full Changelog: https://github.com/google-gemini-php/client/compare/2.1.2...2.2.0

What's Changed

• docs(readme): fix gemini class import error by @dushmanta05 in https://github.com/google-gemini-php/client/pull/109
• Fix a serialization issue for function calls with no args by @Plytas in https://github.com/google-gemini-php/client/pull/112

New Contributors

• @dushmanta05 made their first contribution in https://github.com/google-gemini-php/client/pull/109

Full Changelog: https://github.com/google-gemini-php/client/compare/2.1.1...2.1.2

What's Changed

• Fix some nullable attributes in GoogleGrounding response classes by @maximetassy in https://github.com/google-gemini-php/client/pull/107

Full Changelog: https://github.com/google-gemini-php/client/compare/2.1.0...2.1.1

What's Changed

• add file test resource by @mayconmedeiroz in https://github.com/google-gemini-php/client/pull/102
• Fix: google grounding is not working by @maximetassy in https://github.com/google-gemini-php/client/pull/105
• Content role should be optional by @Plytas in https://github.com/google-gemini-php/client/pull/106

New Contributors

• @mayconmedeiroz made their first contribution in https://github.com/google-gemini-php/client/pull/102

Full Changelog: https://github.com/google-gemini-php/client/compare/2.0.0...2.1.0

What's Changed

Please refer to updagrade guide for more information.

• Moving to Gemini beta API (structured output + system instructions + file uploads) by @Plytas in https://github.com/google-gemini-php/client/pull/91
• Implemented function calling by @Plytas in https://github.com/google-gemini-php/client/pull/92
• Add missing DataFormat and support propertyOrdering for Object Schema by @maximetassy in https://github.com/google-gemini-php/client/pull/93
• Hanlding avgLogprobs infinity by @Plytas in https://github.com/google-gemini-php/client/pull/94
• Model description can be nullable by @Plytas in https://github.com/google-gemini-php/client/pull/95
• Define require psr http implementation to make php-http/discovery auto discovery working by @alexander-schranz in https://github.com/google-gemini-php/client/pull/83
• Updated whole code base from Gemini API documentation by @Plytas in https://github.com/google-gemini-php/client/pull/97
• Add PHP 8.4 to testing matrix by @Plytas in https://github.com/google-gemini-php/client/pull/98
• Deprecate ModelType enum by @Plytas in https://github.com/google-gemini-php/client/pull/99
• Fix Undefined array key "safetyRatings" in PromptFeedback by @200-0K in https://github.com/google-gemini-php/client/pull/80
• Fix for when response comes with no parts by @Plytas in https://github.com/google-gemini-php/client/pull/100

New Contributors

• @maximetassy made their first contribution in https://github.com/google-gemini-php/client/pull/93
• @alexander-schranz made their first contribution in https://github.com/google-gemini-php/client/pull/83
• @200-0K made their first contribution in https://github.com/google-gemini-php/client/pull/80

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.15...2.0.0

What's Changed

• Update README.md for correct example using custom model by @devaex in https://github.com/google-gemini-php/client/pull/59
• Align GenerativeModelTestResource with GenerativeModel by @Plytas in https://github.com/google-gemini-php/client/pull/57

New Contributors

• @devaex made their first contribution in https://github.com/google-gemini-php/client/pull/59
• @Plytas made their first contribution in https://github.com/google-gemini-php/client/pull/57

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.14...1.0.15

What's Changed

• Update README.md for correct example using custom model by @devaex in https://github.com/google-gemini-php/client/pull/59
• Align GenerativeModelTestResource with GenerativeModel by @Plytas in https://github.com/google-gemini-php/client/pull/57
• Implement file uploading and inclusion within chat messages by @davidcochrum in https://github.com/google-gemini-php/client/pull/60
• Add $outputDimensionality param to embedContent method

New Contributors

• @devaex made their first contribution in https://github.com/google-gemini-php/client/pull/59
• @Plytas made their first contribution in https://github.com/google-gemini-php/client/pull/57
• @davidcochrum made their first contribution in https://github.com/google-gemini-php/client/pull/60

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.6-beta...1.0.7-beta

What's Changed

• Update README.md for correct example using custom model by @devaex in https://github.com/google-gemini-php/client/pull/59
• Align GenerativeModelTestResource with GenerativeModel by @Plytas in https://github.com/google-gemini-php/client/pull/57

New Contributors

• @devaex made their first contribution in https://github.com/google-gemini-php/client/pull/59
• @Plytas made their first contribution in https://github.com/google-gemini-php/client/pull/57

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.14...1.0.15

What's Changed

• refactor: Make nullable uri variable in CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/55

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.5-beta...1.0.6-beta

What's Changed

• refactor: Make nullable uri variable in CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/55

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.13...1.0.14

What's Changed

• refactor: Make nullable license variable in CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/52

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.4-beta...1.0.5-beta

What's Changed

• refactor: Make nullable license variable in CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/52

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.12...1.0.13

What's Changed

• feat: Add system promt support for beta by @davidgustys in https://github.com/google-gemini-php/client/pull/45
• Optional license by @canparam in https://github.com/google-gemini-php/client/pull/49
• main --> beta by @aydinfatih in https://github.com/google-gemini-php/client/pull/50

New Contributors

• @davidgustys made their first contribution in https://github.com/google-gemini-php/client/pull/45
• @canparam made their first contribution in https://github.com/google-gemini-php/client/pull/49

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.3-beta...1.0.4-beta

What's Changed

• Optional license by @canparam in https://github.com/google-gemini-php/client/pull/49

New Contributors

• @canparam made their first contribution in https://github.com/google-gemini-php/client/pull/49

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.11...1.0.12

What's Changed

• refactor: Make the $finishReason parameter in Candidate nullable by @aydinfatih in https://github.com/google-gemini-php/client/pull/46

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.2-beta...1.0.3-beta

What's Changed

• refactor: Make the $finishReason parameter in Candidate nullable by @aydinfatih in https://github.com/google-gemini-php/client/pull/46

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.10...1.0.11

What's Changed

• Fix issue Undefined array key "candidatesTokenCount" by @lamberttraccard in https://github.com/google-gemini-php/client/pull/37
• Update MimeType.php adding application/pdf by @tfranca2 in https://github.com/google-gemini-php/client/pull/39
• Support for tuned models by @gregpriday in https://github.com/google-gemini-php/client/pull/41

New Contributors

• @lamberttraccard made their first contribution in https://github.com/google-gemini-php/client/pull/37
• @tfranca2 made their first contribution in https://github.com/google-gemini-php/client/pull/39
• @gregpriday made their first contribution in https://github.com/google-gemini-php/client/pull/41

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.1-beta...1.0.2-beta

What's Changed

• Support for tuned models by @gregpriday in https://github.com/google-gemini-php/client/pull/41

New Contributors

• @gregpriday made their first contribution in https://github.com/google-gemini-php/client/pull/41

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.9...1.0.10

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.0-beta...1.0.1-beta

What's Changed

• Update MimeType.php adding application/pdf by @tfranca2 in https://github.com/google-gemini-php/client/pull/39

New Contributors

• @tfranca2 made their first contribution in https://github.com/google-gemini-php/client/pull/39

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.8...1.0.9

What's Changed

• Fix issue Undefined array key "candidatesTokenCount" by @lamberttraccard in https://github.com/google-gemini-php/client/pull/37

New Contributors

• @lamberttraccard made their first contribution in https://github.com/google-gemini-php/client/pull/37

Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.7...1.0.8