API 文档 · Dify
在 Dify 中接入 GPTZZZ
用 GPT 分组的 Key：在 Dify 插件市场安装 GPTZZZ 插件，只填 API Key。要自己逐个添加模型：用 Dify 官方的 OpenAI-API-compatible 插件，API Base URL 填 https://gptzzz.ai/v1。Claude官key 分组用 Anthropic 插件，API URL 填 https://gptzzz.ai。不管哪种，一个 Key 只能调用它所属分组里的模型。
插件信息核验于 2026-10-10：GPTZZZ 插件 0.0.1，OpenAI-API-compatible 插件 0.0.68，Anthropic 插件 0.3.34。Dify 界面文字以你使用的版本为准。
先选接法
按 Key 所属分组选插件。三个插件都在 Dify 插件市场，Dify Cloud 和当前自部署版的入口都是 集成 > 模型供应商。较早的自部署版本没有 集成 菜单时，入口在账户菜单的 设置 > 模型供应商。
| 插件 | 用哪个分组的 Key | 在 Dify 里填什么 | 说明 |
|---|---|---|---|
GPTZZZ（gptzzz/gptzzz） | opai puls、opai pro、pro200-500不降智、GPT官key | API Key | 地址固定为 https://gptzzz.ai/v1；预置 4 个 GPT 模型；需要 Dify 1.9.0 及以上 |
OpenAI-API-compatible（langgenius/openai_api_compatible） | 任一 GPT 分组；其他官方 Key 分组按控制台给出的接口 | 模型名称、API Key、API Base URL、上下文长度 | 每个模型单独添加 |
Anthropic（langgenius/anthropic） | Claude官key | 模型名称、API Key、API URL | Claude 分组走 Claude Messages 接口 /v1/messages |
只有 Dify 工作空间的所有者和管理员能管理模型供应商。填进去的 Key 在整个工作空间生效，建议给 Dify 单独建一个 Key，方便日后撤销。
Key 与分组：Key 只调自己分组的模型
每个 API Key 只属于一个分组，只能调用这个分组里的模型。登录后在控制台 /keys 创建 Key，创建时选择分组。要用几家厂商的模型，就为对应分组各建一个 Key，余额共用。各分组包含哪些模型，见模型广场 · 分组一览。
| 分组 | 类型 · 计费倍率 | Dify 里用哪个插件 | 模型 ID 示例 |
|---|---|---|---|
| opai puls / opai pro | GPT 订阅号池 · 0.05x / 0.1x | GPTZZZ 或 OpenAI-API-compatible | gpt-5.5、gpt-5.6、gpt-6-astra |
| pro200-500不降智 | GPT 订阅号池 · 0.25x | GPTZZZ 或 OpenAI-API-compatible | gpt-6.1-sol、gpt-5.6-sol、gpt-5.5 |
| GPT官key | 官方 Key · 0.54x | GPTZZZ 或 OpenAI-API-compatible | gpt-5.5、gpt-5.4-pro、gpt-5.6-terra |
| Claude官key | 官方 Key · 0.39x | Anthropic | claude-sonnet-5、claude-opus-5.5 |
| Gemini官key、DeepSeek官key、Grok官key、Qwen 通义官key、MiMo 小米官key | 官方 Key · 0.92x、0.77x、0.67x、0.7x、0.64x | 可用接口以控制台为准；给出 OpenAI 兼容接口时用 OpenAI-API-compatible | gemini-3.1-pro、deepseek-v4-pro、qwen3.8-flash |
模型 ID 要逐字复制，不要用昵称。每个模型在各分组的价格见模型广场；与控制台不一致时，以控制台为准。
方式一：GPTZZZ 插件
插件市场名称 GPTZZZ，插件 ID gptzzz/gptzzz，当前版本 0.0.1（2026-09-16 上架），类型为模型供应商，只提供 LLM。请求地址在插件里固定为 https://gptzzz.ai/v1，界面上不能改。源码公开在 github.com/gptzzz/dify-plugin-gptzzz（MIT 许可）。
- 在控制台 /keys 为 GPT 分组创建一个 API Key。
- 在 Dify 打开 集成 > 模型供应商，在 安装模型供应商 区域找到 GPTZZZ 并安装。也可以在插件市场页面安装；如果跳到了另一个 Dify 环境，清除 安装偏好设置 里保存的地址再装。
- 在 GPTZZZ 卡片上点 设置，粘贴 API Key，保存。
- 保存时 Dify 会校验 Key：插件用
gpt-5.6-terra发一次很短的请求。四个 GPT 分组都含这个模型，所以 GPT 分组的 Key 能通过；其他分组的 Key 会校验失败。
插件预置了 4 个模型，但不是每个分组都全有：
| 预置模型 | 所在分组 |
|---|---|
gpt-6-astra | opai puls、opai pro、pro200-500不降智、GPT官key |
gpt-5.6 | 只在 opai puls、opai pro |
gpt-5.6-sol | opai puls、opai pro、pro200-500不降智、GPT官key |
gpt-5.6-terra | opai puls、opai pro、pro200-500不降智、GPT官key |
用 pro200-500不降智 或 GPT官key 的 Key 时，gpt-5.6 会出现在 Dify 的模型列表里，但调用会失败。换成同组里有的模型即可。
要用预置列表以外的模型（比如 gpt-5.5），在 GPTZZZ 卡片上点 添加模型：模型名称填精确 ID，再填一次 API Key。上下文长度和最大 token 上限的默认值是插件作者设的（1050000 和 128000），按厂商官方文档里该模型的数值改。GPTZZZ 模型广场不列上下文长度。
插件里写的美元单价只用于 Dify 内的费用估算，写于 2026-09-16。实际扣费以模型广场和控制台为准。
方式二：OpenAI-API-compatible 插件
这是 Dify 官方维护的插件（langgenius/openai_api_compatible，当前版本 0.0.68）。它没有预置模型，每个模型在卡片上点 添加模型 单独加。插件会在 API Base URL 后面自己拼 /chat/completions，所以地址只填到 /v1。
| 字段 | 填写 |
|---|---|
| 模型类型（Type） | LLM。GPTZZZ 暂不支持 embeddings，不要加 Text Embedding 类型。 |
| 模型名称 | 精确模型 ID，例如 gpt-5.5 |
| 模型显示名称 | 可选，只影响 Dify 界面 |
| API Key | GPTZZZ 的 Key，分组必须包含上面的模型 |
| API Base URL | https://gptzzz.ai/v1 |
| API endpoint中的模型名称 | 留空。填了会代替模型名称发给接口。 |
| 对话类型 | 对话 |
| 模型上下文长度 | 必填，默认 4096。按厂商官方文档里该模型的上下文窗口填，GPTZZZ 模型广场不列这个值。不要保留 4096：Dify 按这个值计算还能放进多少对话历史。 |
| 最大 token 上限 | 默认 4096，按需调整 |
| API 类型 | 默认 Chat Completions API (/chat/completions) |
| token 参数名 | 保持“自动（按模型判断）” |
| 函数调用类型 | 默认不支持；工作流或 Agent 要调用工具时选“工具调用” |
| 视觉支持 | 要传图片时选“支持” |
保存时，插件会用你填的模型发一个 ping 请求校验。Key 的分组不含这个模型，就会校验失败。其他开关先保持默认，测通后再逐项打开。
GPTZZZ 的 OpenAI 分组已实测 /v1/chat/completions（含流式、工具调用、JSON 模式）和 /v1/responses。图片输入要用 base64，传图片 URL 会失败。
Claude官key 分组：用 Anthropic 插件
GPTZZZ 的 Claude 分组走 Claude Messages 接口 https://gptzzz.ai/v1/messages。Dify 官方的 Anthropic 插件（langgenius/anthropic，当前版本 0.3.34）有 API URL 字段，也支持添加模型，可以指向 GPTZZZ。
- 在控制台 /keys 为 Claude官key 分组创建 Key。
- 在 集成 > 模型供应商 安装 Anthropic 插件。
- 在 Anthropic 卡片上点 添加模型：模型名称填 GPTZZZ 的模型 ID，例如
claude-sonnet-5；API Key 填 Claude官key 分组的 Key；API URL 填https://gptzzz.ai，不带/v1。 - 只在 Dify Cloud 上：Dify 给 Anthropic 等几家供应商提供 AI 消息额度，额度和你的 Key 可以同时存在。如果 Anthropic 卡片上有 AI 消息额度，把卡片上的 使用优先级 设为优先用你自己的 Key，否则请求可能先走 Dify 的额度，不经过 GPTZZZ。
不要用卡片上的 设置。它保存时用 claude-sonnet-4-6 校验，GPTZZZ 里没有这个写法（GPTZZZ 写作 claude-sonnet-4.6）。添加模型时，校验发给你填的模型。
Anthropic 插件按模型名的开头决定提供哪些参数，它的名单用官方的连字符写法（如 claude-opus-4-8、claude-opus-5-5）。claude-sonnet-5、claude-opus-5、claude-fable-5 和官方写法一致，插件能认出来。第一次测试用 claude-sonnet-5 最省事。
用带点号的 claude-opus-4.8、claude-opus-4.7、claude-opus-5.5 时，模型参数里只调 最大标记。温度、Top P、取样数量、推理模式、推理预算 都不要启用。在工作流或 Chatflow 的 LLM 节点里，Dify 默认已启用温度（0.7），选 claude-opus-4.8 或 claude-opus-4.7 后要手动关掉。原因：插件把 claude-opus-4.8、claude-opus-4.7 当成旧模型，启用这些参数会发出这两个模型不接受的采样参数或推理预算；claude-opus-5.5 的推理模式一旦设成关闭，插件会请求关闭思考，这个模型也不接受。这两种请求都可能返回 400。
在聊天助手里测一次
- 在 Dify 新建一个 聊天助手 应用。
- 在右侧 调试与预览 面板选模型：GPTZZZ、OpenAI-API-compatible 或 Anthropic 下你刚加的那个。
- 发一句短消息，等回复。
- 要比较几个模型，用 多个模型进行调试，最多同时跑 4 个。
- 回到 GPTZZZ 控制台核对用量。控制台里能看到这次调用的扣费，才说明请求经过了 GPTZZZ，Key、地址和模型 ID 都对。只有回复、控制台没有记录时，先查上文 Dify Cloud 的 使用优先级。
Dify 里报错时，先在命令行用同一个 Key 和模型直接请求一次，分清是 Dify 配置的问题还是 Key 的问题。GPT 分组和 Claude官key 分组的 Key 不能混用，各用各的 Key 测。
GPT 分组（OpenAI 兼容接口）：
# 粘贴 GPT 分组的 Key
export GPTZZZ_API_KEY="<GPT 分组的 Key>"
curl https://gptzzz.ai/v1/chat/completions \
-H "Authorization: Bearer $GPTZZZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-5.5", "messages": [{"role": "user", "content": "ping"}]}'Claude官key 分组（Claude Messages 接口）：
# 粘贴 Claude官key 分组的 Key
export GPTZZZ_API_KEY="<Claude官key 分组的 Key>"
curl https://gptzzz.ai/v1/messages \
-H "x-api-key: $GPTZZZ_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model": "claude-sonnet-5", "max_tokens": 64, "messages": [{"role": "user", "content": "ping"}]}'命令行能通、Dify 不通：问题在 Dify 的配置或网络。命令行也不通：先查 Key、分组和模型 ID。
排错
| 现象 | 常见原因 | 处理 |
|---|---|---|
| 401，或保存时提示鉴权失败 | Key 复制不全、带了空格或换行、已被撤销 | 在 /keys 核对 Key 后重新粘贴。GPTZZZ 接受 Authorization: Bearer 或 x-api-key 请求头（GPTZZZ 插件和 OpenAI-API-compatible 插件用前者，Anthropic 插件用后者）；Key 放在 URL 参数里会被拒绝。 |
| 404 | 地址多了或少了 /v1，或填成了完整路径 | OpenAI-API-compatible 的 API Base URL 填 https://gptzzz.ai/v1，不要带 /chat/completions。Anthropic 插件的 API URL 填 https://gptzzz.ai，不要带 /v1。 |
| GPTZZZ 插件保存失败，Key 本身没问题 | Key 不属于 GPT 分组；插件用 gpt-5.6-terra 校验 | 换 GPT 分组的 Key；其他分组改用 OpenAI-API-compatible 或 Anthropic 插件 |
| 某个模型调用失败，同一个 Key 调别的模型正常 | Key 的分组不含这个模型，例如用 pro200-500不降智 的 Key 调 gpt-5.6 | 对照分组一览换成同组的模型，或为该模型所在分组另建 Key |
| 自部署 Dify 超时、连不上 | Dify 服务器或 plugin_daemon 容器不能通过 HTTPS 访问 gptzzz.ai | 在 Dify 服务器上运行下面的网络测试。返回 200 或 401：服务器能访问 gptzzz.ai（401 只说明 Key 没带对），再查 plugin_daemon 容器的出站网络和代理设置。超时或连接失败：先查服务器的防火墙、DNS 和出口代理。 |
| 自部署 Dify 装不了插件市场的插件 | MARKETPLACE_ENABLED 设成了 false，或服务器访问不到 marketplace.dify.ai；插件依赖下载慢 | 检查 MARKETPLACE_ENABLED 和 MARKETPLACE_API_URL；依赖下载慢时设置 PIP_MIRROR_URL |
| Anthropic 插件调 Claude 返回 400 | 用带点号的 ID（如 claude-opus-4.8、claude-opus-5.5）时启用了温度、Top P、取样数量、推理模式或推理预算（工作流和 Chatflow 的 LLM 节点默认启用温度） | 关掉这些参数后重试，见上文 Claude官key 分组 |
| 带图片的请求报错 | 图片以 URL 形式发送 | GPTZZZ 的图片输入要用 base64。自部署 Dify 保持 MULTIMODAL_SEND_FORMAT=base64（默认值） |
| 429 | 限速，或额度不足 | 在控制台确认余额和额度，降低并发后重试 |
| 5xx 或流式中断 | 网关或上游异常 | 记下 UTC 时间、模型 ID 和请求 ID，先看服务状态 |
自部署 Dify 的网络测试，在 Dify 服务器上运行（用 GPT 分组的 Key）：
# 粘贴 GPT 分组的 Key
export GPTZZZ_API_KEY="<GPT 分组的 Key>"
curl -sS -o /dev/null -w "%{http_code}\n" https://gptzzz.ai/v1/models \
-H "Authorization: Bearer $GPTZZZ_API_KEY"上表的环境变量说明见 Dify 文档的环境变量页。更多状态码对照见 AI API 错误码速查；仍无法定位时，带上脱敏信息联系技术支持。
常见问题
GPTZZZ 插件和 OpenAI-API-compatible 插件选哪个？
只用 GPT 分组的模型，选 GPTZZZ 插件：只填 API Key，地址已固定为 https://gptzzz.ai/v1。想逐个设置模型参数，或要接控制台给出 OpenAI 兼容接口的其他分组，选 OpenAI-API-compatible 插件。Claude官key 分组用 Anthropic 插件。
一个 Key 能在 Dify 里同时调用 GPT 和 Claude 吗？
不能。每个 API Key 只属于一个分组，只能调用这个分组里的模型。在控制台为 GPT 分组和 Claude官key 分组各建一个 Key，分别填进对应的插件，余额共用。
Dify 知识库能用 GPTZZZ 做 Embedding 吗？
不能。GPTZZZ 暂不支持 embeddings，GPTZZZ 插件也只提供 LLM。知识库需要的 Embedding 模型，请在 Dify 里另配其他供应商。
自部署 Dify 需要什么版本？
GPTZZZ 插件要求 Dify 1.9.0 及以上。低于 1.9.0 时可以试用 OpenAI-API-compatible 插件：插件市场没有给它标更高的最低版本，但能否安装和运行，以你的 Dify 版本实际为准。
相关文档
- GPTZZZ API 文档：Base URL、Key 鉴权与排错顺序
- 在 Vercel AI SDK 中接入 GPTZZZ
- OpenAI 兼容客户端接入与最小验证
- Claude API 接入：请求格式、流式输出与排错
- API Key 安全指南
- Dify 文档：模型供应商
核验日期：本页于 2026-10-10 核对了 Dify 插件市场的三个插件页、GPTZZZ 插件源码和 Dify 官方文档。插件会更新，Dify 界面文字随版本变化；模型、分组与价格以模型广场和控制台为准。