# WordPress 7.0 內建 AI Client：外掛開發者的統一 AI 介面指南 *Published:* 2026-03-24 *Author:* 殼殼蟲 WordPress 7.0 引入了一個內建的 AI Client——一個與提供商無關的 PHP[3](#689cb4e8) API，讓外掛可以將 prompt 傳送給 AI 模型並透過統一介面接收結果。外掛只需描述自己需要什麼，WordPress 負責將請求路由到網站管理員配置的 AI 提供商。 這意味著外掛開發者不再需要自己整合 OpenAI、Anthropic 或 Google 的 API。你只需要呼叫 WordPress 提供的標準介面，站點管理員在後臺的 Settings > Connectors 頁面配置好 API 金鑰和偏好模型即可。 基本用法 ---- 所有互動都從一個入口函式開始： ``` $text = wp_ai_client_prompt( '總結 WordPress 快取的好處。' ) ->using_temperature( 0.7 ) ->generate_text(); ``` API 採用流暢的鏈式呼叫風格。你可以設定溫度引數、指定輸出格式、傳遞 JSON[2](#d70e36fc) schema 來獲取結構化資料。如果需要更豐富的後設資料（比如 token 用量、提供商資訊），可以使用 `generate_text_result()`、`generate_image_result()` 等方法，它們返回一個 `GenerativeAiResult` 物件，包含 token 用量、提供商和模型的詳細資訊。 支援的生成型別 ------- AI Client 不限於文字生成。它原生支援多種模態：文字生成（`generate_text`）、圖片生成（`generate_image`）、文字轉語音（`convert_text_to_speech`）、語音生成（`generate_speech`）以及影片生成（`generate_video`）。每種模態都有對應的 `generate_*_result()` 方法返回帶後設資料的完整結果。 值得注意的是，`GenerativeAiResult` 物件是可序列化的，可以直接傳遞給 `rest_ensure_response()`，這意味著你可以輕鬆地透過 REST API[1](#1984d9d9) 暴露 AI 功能。 模型偏好與提供商配置 ---------- 每個站點可用的模型取決於管理員在 Connectors 頁面配置了哪些 AI 提供商。外掛可以透過模型偏好來表達自己的需求：指定功能需求（如”需要支援文字生成”）、設定上下文視窗大小、或者建議特定的模型類別。WordPress 會根據這些偏好自動選擇最合適的提供商和模型。 對中文開發者意味著什麼 ----------- 這是 WordPress Core 第一次提供標準化的 AI 能力介面。對中文外掛開發者來說，這意味著幾件事： 第一，降低門檻。不需要深入研究各個 AI 提供商的 API 差異，一套程式碼就能適配所有提供商。 第二，使用者自主權。終端使用者可以選擇自己信任的 AI 提供商，而不是被外掛鎖定在某一個服務上。對於關注資料主權的中國使用者來說，這一點尤為重要。 第三，生態統一。當所有外掛都透過同一個 AI Client 介面工作時，使用者體驗會更一致，API 金鑰管理也更簡單。 原文作者 Felix Arntz 是 WordPress Core 的關鍵貢獻者，文章中包含大量程式碼示例。如果你是外掛開發者，建議閱讀[原文](https://make.wordpress.org/core/2026/03/24/introducing-the-ai-client-in-wordpress-7-0/)獲取完整的技術細節。 ### 名詞解釋 1. REST API：基於 HTTP 協議的應用程式介面，用於系統間資料互動 [↩︎](#1984d9d9-link) 2. JSON：一種輕量級的資料交換格式 [↩︎](#d70e36fc-link) 3. PHP：WordPress 核心使用的服務端程式語言 [↩︎](#689cb4e8-link)