# Dify 接入指南

https://omnimodel.me/apps/dify?lang=zh

> 低代码应用编排平台，把模型接进工作流、智能体和知识库问答。

## 适用场景

适合把模型接进可视化工作流、智能体和知识库问答应用。添加 OpenAI 兼容模型供应商后，就能在各类节点里选择平台上的模型。

## 使用建议

工作流会批量、自动地调用模型，建议给密钥设置每月消费上限，并在[用量](/docs/usage)里关注失败率。

## 连不通时检查

1. API 地址填 `https://omnimodel.me/v1`，不要多写 `/chat/completions`。
2. 密钥以 `key_` 开头且没有被暂停或撤销，错误码 `auth.invalid_key` 表示密钥不可用。
3. 模型 ID 与[模型目录](/catalog)一致，并且在这把密钥的可用模型里。
4. 余额不足会返回 `billing.insufficient_credit`，更多错误见[常见错误](/docs/errors)。

## 配置步骤

1. 进入「设置 → 模型供应商」，选择 OpenAI-API-compatible。
2. 填入模型名称、API Key 与 API endpoint URL。
3. 保存后在应用编排里选择该模型。

## 配置参数

- API 地址：`https://omnimodel.me/v1`
- API 密钥：`YOUR_API_KEY`
- 模型：`MODEL_ID`

## 常见问题

### 知识库需要什么模型？

知识库检索需要向量模型，请额外添加一个带「向量」能力的模型用于嵌入。

### 工作流失败会扣费吗？

失败的模型调用不收费，但工作流中已经成功的节点调用会正常计费。