> 说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何兼容 OpenAI 或 Anthropic 格式的网关都一样，换成你自己用的地址即可。

[Dify](https://docs.dify.ai) 是开源的 LLM 应用开发平台，能搭聊天机器人、Agent、工作流和知识库（RAG）。它通过「模型供应商插件」调用模型，接第三方网关时，字段一多很容易填错。这篇按 Dify 官方插件 `openai_api_compatible`（0.0.68 版）和 `anthropic` 的实际字段，讲清楚每一项该填什么。

## 选哪个供应商插件

| 插件 | 地址字段 | 能用的模型 | 适合 |
|---|---|---|---|
| **OpenAI-API-compatible** | API Base URL：`https://api.apivai.com/v1` | Claude 和 GPT | 一个供应商管所有模型，模型 ID 自己填 |
| **Anthropic** | API URL：`https://api.apivai.com` | 只有 Claude | 只用 Claude，想要原生格式和提示词缓存 |

建议先用 **OpenAI-API-compatible**：模型 ID 是自己填的，网关一上新模型就能直接用。

供应商配置在 **Model Provider** 页面：新版 Dify Cloud 在 **Integrations** 下，较旧的自部署版本在账户菜单的 **Settings** 下。每个供应商的配置对整个工作空间生效，只有所有者和管理员能改。

## 第 1 步：安装插件

打开 **Model Provider**，在可安装列表里（或 [Dify Marketplace](https://marketplace.dify.ai/)）找到 **OpenAI-API-compatible**，点 **Install**。

## 第 2 步：添加模型

在 **OpenAI-API-compatible** 卡片上点 **Add Model**，按下表填：

| 字段 | 值 |
|---|---|
| Model Type | LLM |
| Model Name | `claude-sonnet-4-6`（准确的模型 ID） |
| Model display name | 可选，比如「Claude Sonnet 4.6」 |
| API Key | 你的 Key |
| API Base URL | `https://api.apivai.com/v1` |
| model name for API endpoint | 留空 |
| Completion mode | Chat |
| Model context size | 不超过该模型的上下文窗口 |
| Upper bound for max tokens | 8192 或更高 |
| Function Call Type | Tool Call |
| Stream function calling | Support |
| API Type | Chat Completions API (/chat/completions) |

其余保持默认。旧版插件里地址字段叫 **API endpoint URL**，填一样的值。

几个容易误解的字段：

- **Model Name** 是 Dify 真正发给 API 的名字，必须是准确 ID；display name 只是界面上显示的。
- **Model context size** 是 Dify 往提示词里塞历史和检索结果时参考的上限。设得比模型实际窗口小没问题，长对话反而更省。
- **Upper bound for max tokens** 只决定应用里 **Max Tokens** 最多能调到多少。思考默认开启、算输出 token，要留出 4096 以上。
- **Function Call Type 选 Tool Call**，Agent 应用才会用原生工具调用。

点 **Save** 时 Dify 会先发一次测试请求校验，通过才保存。需要几个模型就重复几次 **Add Model**（Key 和地址一样），比如再加 `gpt-5.5`、`claude-haiku-4-5`。

模型 ID 以接口返回为准：

```bash
curl https://api.apivai.com/v1/models -H "Authorization: Bearer 你的Key"
```

## 第 3 步：在应用里用

- 应用的模型选择器里，在 OpenAI-API-compatible 下面选模型，参数里把 **Max Tokens** 设到 4096 以上。
- 工作流里每个 **LLM** 节点可以单独选模型，便宜的和强的可以放在同一个流程里。
- **Model Provider** 页面的 **Default Models** 里设置 **System Reasoning Model**，作为工作空间的默认模型。

## 另一种方式：Anthropic 插件接 Claude

1. 安装 **Anthropic** 插件，打开设置。
2. **API Key** 填你的 Key，**API URL** 填 `https://api.apivai.com`，**不要加 `/v1`**（插件里的 Anthropic 客户端会自己拼 `/v1/messages`）。**Enable request metadata** 保持 Disabled。
3. 插件自带的模型列表里，有的 ID 和网关一致（如 `claude-sonnet-4-6`），有的名字不同或带日期。列表里没有、或者报 model not found 时，在 Anthropic 卡片上点 **Add Model** 手动填准确 ID。

## 工作流里怎么分配模型

- Question Classifier、信息提取、高流量问答：`claude-haiku-4-5` 或 `gpt-6-luna`
- 聊天机器人、Agent 的默认：`claude-sonnet-4-6`
- 工具多的 Agent、长文档：`claude-sonnet-5-5`
- 只有最难的推理节点才用：`claude-opus-5-5`

分流工作流（先用便宜模型分类，再把难的交给强模型）是 Dify 里最常见的省钱做法。

## 常见报错

- **保存时校验失败 / 401**：Key 没复制全或已经被删了；也检查 API Base URL 是不是多写或少写了 `/v1`。
- **402 / insufficient_quota**：这个 Key 的预算用完了，或者剩得太少、不够贵的模型（Opus、Sonnet 4.6 等）发一次请求。给 Key 加点预算，或者把这个节点换成便宜的模型。Key 在还剩一点钱时就会停用，这部分不会丢，删掉 Key 会退回账户余额。
- **404**：OpenAI-API-compatible 要 `https://api.apivai.com/v1`，不要加 `/chat/completions`；Anthropic 插件要 `https://api.apivai.com`，不带 `/v1`。
- **model not found**：Model Name 填的是显示名称而不是 ID，或者在 Anthropic 插件里用了它自带列表里带日期的旧名字。
- **回复被截断或为空**：应用参数里的 Max Tokens 太小（思考会占输出），调到 4096 以上；同时确认 Upper bound for max tokens 足够大。
- **Agent 不调用工具**：Function Call Type 没选 Tool Call。
- **知识库检索报错**：知识库需要嵌入（embedding）模型，APIVAI 不提供 embeddings，要另配一个嵌入模型供应商；回答用的 LLM 仍可以是 Claude 或 GPT。
- **429**：默认每个 Key 每分钟 60 次请求，高流量应用可以按应用分多个 Key。

有问题欢迎评论区交流。


说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何兼容 OpenAI 或 Anthropic 格式的网关都一样，换成你自己用的地址即可。

Dify 接入 Claude / GPT API：OpenAI-API-compatible 插件每个字段怎么填

按 Dify 官方 OpenAI-API-compatible 和 Anthropic 插件的实际字段，讲清楚接入 Claude 和 GPT 时每一项该填什么、工作流里怎么分配模型，以及 401、402、404 等常见报错。

人工智能

后端

开发工具

本文详解Dify平台接入APIVAI网关的完整配置教程，涵盖OpenAI-API-compatible与Anthropic两种插件方案。重点说明API Base URL、模型ID、上下文长度等关键字段的填法，并提供常见错误排查指南，助你快速搭建基于Claude和GPT的AI应用。

聊天机器人

代码解释

Agent

2026上云采购 | AI焕新·智启新局

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Dify 接入 Claude / GPT API：OpenAI-API-compatible 插件每个字段怎么填-腾讯云开发者社区-腾讯云

Dify 接入 Claude / GPT API：OpenAI-API-compatible 插件每个字段怎么填

Dify 接入 Claude / GPT API：OpenAI-API-compatible 插件每个字段怎么填

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐