WordPress 7.0 內置 AI Client：插件開發者的統一 AI 接口指南

WordPress 7.0 引入了一個內置的 AI Client——一個與提供商無關的 PHP³ 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² 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¹ 暴露 AI 功能。

模型偏好與提供商配置

每個站點可用的模型取決於管理員在 Connectors 頁面配置了哪些 AI 提供商。插件可以通過模型偏好來表達自己的需求：指定功能需求（如”需要支持文本生成”）、設置上下文窗口大小、或者建議特定的模型類別。WordPress 會根據這些偏好自動選擇最合適的提供商和模型。

對中文開發者意味着什麼

這是 WordPress Core 第一次提供標準化的 AI 能力接口。對中文插件開發者來説，這意味着幾件事：

第一，降低門檻。不需要深入研究各個 AI 提供商的 API 差異，一套代碼就能適配所有提供商。

第二，用户自主權。最終用户可以選擇自己信任的 AI 提供商，而不是被插件鎖定在某一個服務上。對於關注數據主權的中國用户來説，這一點尤為重要。

第三，生態統一。當所有插件都通過同一個 AI Client 接口工作時，用户體驗會更一致，API 密鑰管理也更簡單。

原文作者 Felix Arntz 是 WordPress Core 的關鍵貢獻者，文章中包含大量代碼示例。如果你是插件開發者，建議閲讀原文獲取完整的技術細節。

名詞解釋

1. REST API：基於 HTTP 協議的應用程序接口，用於系統間數據交互 ↩︎
2. JSON：一種輕量級的數據交換格式 ↩︎
3. PHP：WordPress 核心使用的服務端編程語言 ↩︎