WP Manifestindependent plugin directory
manifest / ai / hydra-ai

Hydra AI

一个能将任意兼容 Chat Completions / Responses / Messages 的 API 接入WordPress 的插件 A plugin that integrates any API compatible with Chat Completions / Responses / Messages into WordPress.

by Hydra AI · github.com/cottboy/hydra-ai

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/cottboy/hydra-ai/archive/refs/heads/master.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/cottboy/hydra-ai ↗

在 WordPress 连接中注册一个自定义 AI 供应商，支持三种协议与多供应商故障转移。

Description

WordPress 7.0 内置的 AI 供应商集成只支持 OpenAI、Gemini、Anthropic 三家。Hydra AI 在 WordPress 连接（Connectors）中注册一个 "Hydra AI" 供应商，并允许你自定义任意端点：

  • 三种协议：Chat Completions（OpenAI 兼容）、Responses API（OpenAI 官方）、Anthropic Messages。
  • 在“设置 → Hydra AI”中以列表方式管理供应商，右上角“添加供应商”即可新增条目。
  • 拖动调整优先级：请求从上到下依次尝试，任一环节失败自动切换到下一个供应商。
  • 每个条目的模型会暴露给 WordPress AI 客户端（AiClient），其他插件可直接使用。
  • 支持连通性测试、启用/禁用开关、密钥回退（条目密钥 > 连接器密钥 > 常量 HYDRA_AI_API_KEY）。
  • 文件输入按各协议原生能力全量支持：图片（JPEG/PNG/GIF/WebP）、PDF 文档、纯文本文档与音频（WAV/MP3）；远端文件在不支持 URL 的协议下自动下载内联（上限 25MB），不支持的类型自动故障转移。
  • 多模态输出：Responses 协议可通过图片生成工具返回图片，Chat Completions 可返回音频，也兼容解析服务端提供的图片与音频内容块。
  • 完整转换多候选、工具调用与结果、结构化输出、推理内容与签名、拒答、停止原因、Token 用量及服务端扩展元数据；支持聚合三协议的 SSE 流式响应。

Installation

  1. 将插件上传到 wp-content/plugins/hydra-ai 并启用。
  2. 前往“设置 → Hydra AI”，点击“添加供应商”配置端点、密钥与模型。
  3. （可选）在“设置 → 连接”中为 Hydra AI 连接器保存一个默认 API Key。

i18n

插件源语言为简体中文，界面文字直接以中文写在代码中；其他语言由 languages/ 下的翻译文件提供：

  • hydra-ai.pot：翻译模板，新增语言时以它为底稿。
  • hydra-ai-en_US.po/.mo：英文翻译，站点语言为 English (United States) 时自动生效。
  • 新增其他语言：复制 en_US 的条目、填入译文并编译为 .mo（或用 Loco Translate 等插件操作），命名格式为 hydra-ai-{语言代码}.po/.mo。

Changelog

1.1.0

  • 接入 WordPress AI Client 的图片生成、语音生成与文本转语音能力，并按模型实际配置的协议动态声明能力。
  • 补齐 Responses 图片生成、Chat 音频输出、多候选与多模态响应，以及 Messages 推理签名和未映射扩展数据保留。
  • 支持聚合 Chat Completions、Responses 与 Messages 的 SSE 流式响应。
  • 完善三协议参数映射与独立协议回归测试。

1.0.2

  • 精简设置页：移除页面底部使用说明、供应商列的端点与密钥状态小字，以及弹窗中名称/端点/模型的占位提示文字。
  • 简化添加供应商弹窗的协议选项文字。

1.0.1

  • 补齐三协议文件输入：音频（WAV/MP3）、PDF 与纯文本文档；远端文件在不支持 URL 的协议下自动下载内联。

1.0.0

  • 首个版本：连接器注册、三协议端点管理、拖拽排序与故障转移。