外掛說明
This plugin provides Google AI (Gemini) integration for the PHP AI Client SDK. It enables WordPress sites to use Google’s Gemini models for text generation, image generation, text to speech, and other AI capabilities.
外掛功能
- 使用 Gemini 模型產生內容
- 使用 Imagen 模型產生圖片
- Text to Speech conversion with Gemini models
- Function calling support
- 自動註冊提供者
這個外掛會動態探索 Google AI API 提供的模型,包含用於產生內容的 Gemini 模型及產生圖片的 Imagen 模型。
環境需求
- PHP 7.4 或更新版本
- 如果網站使用 WordPress 6.9,則必須安裝 PHP AI Client 套件
- 如果網站使用 WordPress 7.0,不需進行任何變更
- Google Gemini API 金鑰
安裝方式
- 將外掛安裝套件 ZIP 壓縮檔解壓縮所得的
ai-provider-for-google資料夾上傳至網站的/wp-content/plugins/目錄中。 - 在 WordPress 管理後台的 [外掛] 選單中啟用外掛。
- 透過
GOOGLE_API_KEY環境變數或常數組態 Google API 金鑰。
常見問題集
-
如何取得 Google API 金鑰?
-
前往 Google AI Studio 以取得 Gemini API 的 API 金鑰。
-
這個外掛是否不需要與 PHP AI Client 搭配使用?
-
否。這個外掛需要安裝並啟用 PHP AI Client 外掛,而這個外掛提供 PHP AI Client 所使用的 Google 專屬實作方案。
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
1.2.0 – 2026-09-21
Added
- Support for text to speech conversion (#31).
- WordPress Playground preview blueprint that installs and activates the AI plugin and Google provider, enables AI and image generation/editing settings, logs in automatically, opens the Connectors screen, and configures Playground networking for provider requests after credentials are set (#43).
Changed
- Updated the supported development baseline to PHP AI Client 1.3.1 and added automated compatibility testing across PHP 7.4–8.4 with the lowest and latest supported dependencies (#40).
Fixed
- Google thought signature round-tripping and thought token usage compatibility for tool-calling requests (#26).
- Gemini tool-calling by preserving
thoughtSignaturevalues across turns so function calls remain valid in multi-step conversations (#36). - Gemini usage parsing to use Google’s authoritative
totalTokenCountwhen available, ensuring prompt tokens are included in reported totals while keeping a backward-compatible fallback for older responses (#44).
1.1.1 – 2026-08-17
Changed
- Bumped WordPress tested-up-to version 7.1 (#39).
Fixed
- Prevented PHP warning and error-log spam when processing base64-encoded images returned by Google AI (#29).
1.1.0
- Add support for aspect ratios with Gemini (multimodal) image generation (#13).
- Add a provider logo to the metadata if the ai client version > 1.3.0 (#20).
- Fix text and image multimodal support so that it properly works regardless of capability chosen (#14).
- Remove
additionalPropertiesfrom the JSON response schema (#18).
1.0.3
- Fix critical bug that prevent use of Gemini image models because of lacking file type support annotation.
1.0.2
- Add plugin directory assets by @shaunandrews in https://github.com/WordPress/ai-provider-for-google/pull/7
- Update tags in readme.txt by @jeffpaul in https://github.com/WordPress/ai-provider-for-google/pull/9
- Fix missing input and output modality combinations, fixing usage of Nano Banana (among other problems) by @felixarntz in https://github.com/WordPress/ai-provider-for-google/pull/11
- Add provider description by @felixarntz in https://github.com/WordPress/ai-provider-for-google/pull/12
1.0.1
- Initial release of the plugin
- Support for Gemini text and image generation models
- Support for Imagen image generation models
- Function calling support
1.0.0
- Initial release of the Composer package
