> ## Documentation Index
> Fetch the complete documentation index at: https://docs.globalai.vip/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Dify 中接入 Global AI 作为模型提供商

> 通过 OpenAI-API-compatible 插件把 Global AI 接入 Dify，用于工作流、Agent 或应用中的推理模型。

Dify 通过内置的「OpenAI-API-compatible」提供商即可接入 Global AI，用作应用与工作流的推理模型。

<Steps>
  <Step title="打开设置">
    在 Dify 顶部导航点击右上角头像，选择「设置」。
  </Step>

  <Step title="安装 OpenAI-API-compatible 提供商">
    在「模型提供商」中找到 **OpenAI-API-compatible**，点击「安装」。
  </Step>

  <Step title="添加模型">
    安装完成后，在 OpenAI-API-compatible 提供商内点击「添加模型」，填写：

    * **模型名称**：从 [globalai.vip/pricing](https://globalai.vip/pricing) 复制模型 ID，如 `gpt-4o`
    * **API endpoint URL**：`https://globalai.vip/v1`
    * **API Key**：粘贴你的 `sk-` 令牌

    其他参数保持默认，点击保存。
  </Step>

  <Step title="设置系统推理模型">
    回到设置顶部的「系统模型设置 → 系统推理模型」，选择刚才添加的模型，保存后退出。
  </Step>

  <Step title="在应用中使用">
    回到 Dify 应用，在工作流节点或应用编排中选择该模型进行测试。响应正常即接入成功。
  </Step>
</Steps>

## 添加多个模型

如果一个应用中需要同时使用 GPT、Claude、Gemini 等多个模型，可以在同一个 OpenAI-API-compatible 提供商下重复「添加模型」步骤，为每个模型 ID 建立一条记录，共用同一个 API Key。

<Tip>
  Claude 与 Gemini 系列虽然是不同厂商，但在 Global AI 都以 OpenAI 兼容格式提供，因此都能通过 OpenAI-API-compatible 提供商添加。只需保证模型 ID 与 [定价页](https://globalai.vip/pricing) 一致即可。
</Tip>

## 排查

<AccordionGroup>
  <Accordion title="添加模型时提示鉴权失败">
    检查 API endpoint URL 是否为 `https://globalai.vip/v1`（含 `/v1`），密钥前后是否有多余空格。
  </Accordion>

  <Accordion title="调用时余额扣得快">
    Dify 工作流可能会在一次运行中多次调用模型，长 Prompt 与检索到的上下文都会计入 Token。请到 [日志](/usage/logs) 按令牌名过滤，定位消耗最多的节点。
  </Accordion>
</AccordionGroup>


## Related topics

- [Global AI 客户端接入总览：常用参数与选型](/clients/overview.md)
- [ChatWise 接入 Global AI：多提供商统一配置指南](/clients/chatwise.md)
- [Cherry Studio 接入 Global AI：Claude、GPT、Gemini 配置](/clients/cherry-studio.md)
- [ChatBox 接入 Global AI：桌面与手机端配置](/clients/chatbox.md)
- [Cline、Roo Code、WorkBuddy 接入 Global AI 指南](/clients/coding-agents.md)