# 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)