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

# Dify 配置

> 在 Dify 中配置 OpenAI 和 Anthropic 模型供应商并接入 gogogotoken API

本页介绍如何在 Dify 中接入 gogogotoken 的模型能力。配置完成后，你可以在 Dify 的聊天助手、Agent、工作流和知识库问答中调用当前 API Key 可用的模型。

## 接入参数

<CardGroup cols={2}>
  <Card title="OpenAI API Key" icon="key-round">
    `YOUR_API_KEY`
  </Card>

  <Card title="OpenAI API Base" icon="globe">
    `https://gogogotoken.ai`
  </Card>

  <Card title="Anthropic API Key" icon="key-round">
    `YOUR_API_KEY`
  </Card>

  <Card title="Anthropic API Base" icon="globe">
    `https://gogogotoken.ai`
  </Card>
</CardGroup>

## OpenAI 的配置

如果你希望在 `Dify` 中调用 gogogotoken 的 GPT / OpenAI 兼容模型，可以在 Dify 的模型供应商中添加 `OpenAI` 配置，然后用一个简单工作流验证调用是否成功。

<Warning>
  Dify 的 OpenAI 供应商配置中，`API Base` 只填写到域名根地址 `https://gogogotoken.ai`。该官方插件会在请求时自动补全 `/v1/chat/completions`，因此**请勿**自行添加 `/v1` 或 `/v1/chat/completions`，否则会出现 `/v1/v1/...` 之类的重复路径报错。
</Warning>

<Steps>
  <Step title="打开 Dify 设置">
    登录 Dify 后，点击左上角头像，在弹出的菜单中进入设置页面。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-settings-entry.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=ffbf320f904f824c252c3c171893fee7" alt="打开 Dify 设置" width="1452" height="960" data-path="images/codex/dify-gpt-settings-entry.jpeg" />
    </Frame>
  </Step>

  <Step title="找到模型供应商选项">
    在设置页面左侧菜单中找到 `模型供应商`。后续所有模型、API Key 和默认模型配置都在这里完成。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-model-provider.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=e46822808b102b8a9fab89ebf01ead27" alt="找到 Dify 模型供应商" width="2376" height="898" data-path="images/codex/dify-gpt-model-provider.jpeg" />
    </Frame>
  </Step>

  <Step title="选择 OpenAI 并点击配置">
    在模型供应商列表中找到 `OpenAI`，点击对应的配置入口。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-openai-config.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=f00dd4707d483bb71b6f8e34a8bdf3f9" alt="选择 OpenAI 并点击配置" width="1588" height="750" data-path="images/codex/dify-gpt-openai-config.jpeg" />
    </Frame>
  </Step>

  <Step title="填写 API Key 和 API Base">
    在 OpenAI 配置窗口中填写 gogogotoken 的接入信息。

    | 配置项      | 填写内容                     |
    | -------- | ------------------------ |
    | API Key  | `YOUR_API_KEY`           |
    | API Base | `https://gogogotoken.ai` |

    API Key 可以在 [令牌管理](/billing/api-key-management) 中创建或复制。这里的 `API Base` 填写到域名根地址即可，不需要手动补 `/v1/chat/completions`。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-openai-form.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=ba97f74f0140bcbd121a11da35755c74" alt="填写 OpenAI API Key 和 API Base" width="1814" height="1506" data-path="images/codex/dify-gpt-openai-form.jpeg" />
    </Frame>

    填写完成后保存配置。如果 Dify 页面要求测试或确认，请按页面提示完成。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-openai-save.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=80aea5f40d2da7ce75d31faba3a69ee1" alt="保存 Dify OpenAI 配置" width="1674" height="1394" data-path="images/codex/dify-gpt-openai-save.jpeg" />
    </Frame>
  </Step>

  <Step title="填写 API Key 和 API Base">
    在 OpenAI 配置窗口中填写 gogogotoken 的接入信息。

    | 配置项      | 填写内容                     |
    | -------- | ------------------------ |
    | API Key  | `YOUR_API_KEY`           |
    | API Base | `https://gogogotoken.ai` |

    API Key 可以在 [令牌管理](/billing/api-key-management) 中创建或复制。这里的 `API Base` 填写到域名根地址即可，OpenAI 官方插件会自动补全 `/v1/chat/completions`，无需手动添加。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-openai-form.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=ba97f74f0140bcbd121a11da35755c74" alt="填写 OpenAI API Key 和 API Base" width="1814" height="1506" data-path="images/codex/dify-gpt-openai-form.jpeg" />
    </Frame>

    填写完成后保存配置。如果 Dify 页面要求测试或确认，请按页面提示完成。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-openai-save.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=80aea5f40d2da7ce75d31faba3a69ee1" alt="保存 Dify OpenAI 配置" width="1674" height="1394" data-path="images/codex/dify-gpt-openai-save.jpeg" />
    </Frame>
  </Step>

  <Step title="修改默认模型">
    回到模型供应商配置页，修改默认模型。

    默认模型需要选择当前 API 令牌分组内已经开通的模型。如果选择了令牌无权限访问的模型，后续工作流运行时会返回模型无权限或模型不存在。

    <Note>
      文档中出现的模型名称仅为示例，具体可用模型请以 gogogotoken 平台「模型广场」发布的模型为准。
    </Note>

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-default-model.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=9a2d3f6ab783591faecb58aac8b93f90" alt="修改 Dify 默认模型" width="1768" height="1144" data-path="images/codex/dify-gpt-default-model.jpeg" />
    </Frame>

    确认默认模型已经切换到当前令牌可用的模型后，再继续创建工作流进行测试。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-default-model-confirm.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=72141b12160e459e2525ed6b60090f46" alt="确认 Dify 默认模型配置" width="1460" height="1290" data-path="images/codex/dify-gpt-default-model-confirm.jpeg" />
    </Frame>
  </Step>

  <Step title="创建工作流并预览测试">
    创建一个简单工作流，在流程中添加 `LLM` 节点，并选择刚刚配置好的模型。

    点击 `预览`，输入一句测试内容。如果 LLM 节点能够正常返回结果，说明 Dify 侧配置已经生效。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-workflow-preview.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=e10a90057786a05197f134b793981fa8" alt="Dify 工作流 LLM 节点预览测试" width="2892" height="1544" data-path="images/codex/dify-gpt-workflow-preview.jpeg" />
    </Frame>
  </Step>

  <Step title="在 gogogotoken 查看日志">
    回到 gogogotoken 官网，在日志页面查看刚才的调用记录。

    如果能看到对应请求、模型和消耗记录，说明 Dify 已经正确通过 gogogotoken 发起调用。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/codex/dify-gpt-token-logs.jpeg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=3c97f9c38fa8804a79d01ac4552c1241" alt="在 gogogotoken 查看 Dify 调用日志" width="2956" height="636" data-path="images/codex/dify-gpt-token-logs.jpeg" />
    </Frame>
  </Step>
</Steps>

## Anthropic 的配置

如果你希望在 Dify 中调用 Claude / Anthropic Messages API 模型，可以在模型供应商中添加 `Anthropic` 配置。Anthropic 供应商适合使用 `claude-sonnet-4-6`、`claude-opus-4-6` 等 Claude 系列模型。

<Note>
  Anthropic 供应商使用的是 Anthropic Messages 协议，与 OpenAI 的 Chat Completions 协议不同，二者是相互独立的供应商，请分别配置、不要混用。
</Note>

<Steps>
  <Step title="打开 Dify 模型供应商">
    登录 Dify 后，点击左上角头像进入设置页面，然后打开 `模型供应商`。

    如果你已经完成上面的 OpenAI 配置，可以继续留在同一个模型供应商页面。

    选择 Anthropic 并点击配置，添加API密钥

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/KxcthPxZTf.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=d8a5d9e5ec81e03012c2f88d00b08798" alt="Kxcth Px Z Tf" width="1572" height="652" data-path="images/KxcthPxZTf.jpg" />
    </Frame>
  </Step>

  <Step title="填写 API Key 和 API Base">
    在 Anthropic 配置窗口中填写：

    | 配置项                | 填写内容                     |
    | ------------------ | ------------------------ |
    | API Key            | `YOUR_API_KEY`           |
    | API Base / API URL | `https://gogogotoken.ai` |

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/pD3DsrBZNA.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=d12beffa1ba532ee50bc75d6c11bdc1d" alt="P D3dsr BZNA" width="1578" height="1010" data-path="images/pD3DsrBZNA.jpg" />
    </Frame>

    API Key 可以在 [令牌管理](/billing/api-key-management) 中创建或复制。`API Base` 只填写到域名根地址即可，Anthropic 官方插件会自动补全 `/v1/messages`，无需手动添加 `/v1` 或其它路径。
  </Step>

  <Step title="配置 Claude 模型">
    在 Anthropic 供应商中添加或选择当前 API 令牌分组内可用的 Claude 模型，例如：

    ```text theme={null}
    claude-sonnet-4-6
    ```

    注意如果模型不在当前令牌分组内，Dify 测试时会返回模型不存在或无权限。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/kQBcnkgVER.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=cf5f734feeb20992eef1478b5d58da25" alt="K Q Bcnkg VER" width="1578" height="1124" data-path="images/kQBcnkgVER.jpg" />
    </Frame>
  </Step>

  <Step title="保存并测试调用">
    保存配置后，在 Dify 的模型测试区发送一条简单消息。

    如果能够正常返回内容，再回到应用、Agent 或工作流中选择该 Anthropic 模型作为 LLM 节点模型

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/lnl7bvtiOw.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=480654de156d7436b4bf24c94df0398f" alt="Lnl7bvti Ow" width="2222" height="1142" data-path="images/lnl7bvtiOw.jpg" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/TqqLgKUVLc.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=6d0290e4e2d96c49e205dce484e1b502" alt="Tqq Lg KUV Lc" width="2704" height="1358" data-path="images/TqqLgKUVLc.jpg" />
    </Frame>
  </Step>

  <Step title="查看 gogogotoken 日志">
    回到 gogogotoken 官网，在日志页面确认刚才的请求记录。

    如果日志中显示对应 Claude 模型和消耗记录，说明 Anthropic 供应商已经正确接入。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/X4GfeByUp8.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=e72ee0734cbf1cf971aa5364b24a7b6f" alt="X4gfe By Up8" width="2602" height="438" data-path="images/X4GfeByUp8.jpg" />
    </Frame>
  </Step>
</Steps>

## OpenAI-API-compatible 的配置

如果你希望在 Dify 中通过通用的 `OpenAI-API-compatible` 供应商接入 gogogotoken，可以使用本章节的步骤。该供应商适合接入任意兼容 OpenAI Chat Completions 协议的模型，例如 `gpt-5.5`、`gemini-2.5-pro`、`qwen3` 等。

<Note>
  `OpenAI-API-compatible` 与上面的 `OpenAI` 供应商是两个独立的供应商，可以并存。如果你需要在同一个 Dify 中同时调用多种模型，推荐使用本方式。
</Note>

<Steps>
  <Step title="打开 Dify 模型供应商">
    登录 Dify 后，点击左上角头像进入设置页面，然后打开 `模型供应商`。

    在供应商列表中找到 `OpenAI-API-compatible`，点击 `安装`。

    <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/pMwfY3sbw1.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=c9833c2f4085dfe50cda019b67e67cb9" alt="P Mwf Y3sbw1" width="1974" height="1346" data-path="images/pMwfY3sbw1.jpg" />
  </Step>

  <Step title="填写 API Key 和 API Base">
    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/YlfyuvGKLY.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=1aa45cb4ee3ad7a3198797772e5efb44" alt="Ylfyuv GKLY" width="1336" height="1334" data-path="images/YlfyuvGKLY.jpg" />
    </Frame>

    <Info>
      这里需要注意，填写的模型要和创建的密钥中的可用模型名称保持一致，第二这个目前是支持OpenAPI的格式，所以暂时不配置claude类的模型
    </Info>

    点击模型配置，在 OpenAI-API-compatible 配置窗口中填写：

    | 配置项              | 填写内容                             |
    | ---------------- | -------------------------------- |
    | 模型类型             | `LLM`                            |
    | 模型名称             | `ggemini-2.5-pro`（或其他你要使用的模型 id） |
    | API Key          | `YOUR_API_KEY`                   |
    | API endpoint URL | `https://gogogotoken.ai/v1`      |

    API Key 可以在 [令牌管理](/billing/api-key-management) 中创建或复制。`API endpoint URL` 需要包含 `/v1` 路径。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/vQBKJuY3dY.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=b0a2595cfa122090c8656fd7f3e05f9e" alt="V QBK Ju Y3d Y" width="2570" height="458" data-path="images/vQBKJuY3dY.jpg" />
    </Frame>
  </Step>

  <Step title="添加模型">
    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/xtofxQDaNK.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=c1d42dfb09513c65f520dec47253bd25" alt="添加 OpenAI-API-compatible 模型" width="1746" height="494" data-path="images/xtofxQDaNK.jpg" />
    </Frame>

    ```text theme={null}
    gpt-5.5
    gemini-2.5-pro
    ```

    文档中以上面两个模型举例，实际可添加任意当前令牌分组内可用的模型 id。

    <Note>
      上述模型名称仅为示例，具体可用模型请以 gogogotoken 平台「模型广场」发布的模型为准。
    </Note>
  </Step>

  <Step title="保存并测试调用">
    保存配置后，在 Dify 的模型测试区或新建一个应用，选择刚刚添加的 OpenAI-API-compatible 模型作为 LLM 节点模型，发送一条简单消息。

    如果能够正常返回内容，说明供应商已经正确接入。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/3rQtOXsvkc.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=332bc82ebe5f38ffce5b5c0519e000cd" alt="测试 OpenAI-API-compatible 模型调用" width="2688" height="1332" data-path="images/3rQtOXsvkc.jpg" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/7le6d3ivA9.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=d71b8328ac62e8fab3367921b38b44a1" alt="模型返回测试结果" width="2652" height="1520" data-path="images/7le6d3ivA9.jpg" />
    </Frame>
  </Step>

  <Step title="查看 gogogotoken 日志">
    回到 gogogotoken 官网，在日志页面确认刚才的请求记录。

    如果日志中显示对应模型和消耗记录，说明 OpenAI-API-compatible 供应商已经正确接入。

    <Frame>
      <img src="https://mintcdn.com/gogogotoken/SVoSxOqdlEcGU5Ly/images/avpwI59t5Q.jpg?fit=max&auto=format&n=SVoSxOqdlEcGU5Ly&q=85&s=588e7a65416e19d78275571d8d634de2" alt="在 gogogotoken 查看 OpenAI-API-compatible 调用日志" width="2614" height="262" data-path="images/avpwI59t5Q.jpg" />
    </Frame>
  </Step>
</Steps>

## 常用模型

| 场景        | 示例 model            |
| --------- | ------------------- |
| 通用对话      | `gpt-5.5`           |
| 长文本与推理    | `claude-sonnet-4-6` |
| 快速响应      | `gpt-5.5`           |
| Gemini 系列 | `gemini-2.5-pro`    |

<Note>
  上表模型名称仅为示例，具体可用模型请以 gogogotoken 平台「模型广场」发布的模型为准。
</Note>

## 常见问题

### 提示模型不存在

先检查模型名称是否和 [模型列表](/overseas/models) 返回的 `id` 完全一致。模型名称区分大小写，也不要额外添加空格。

### 提示 API Key 无效

确认 API Key 是否完整复制，并检查请求头是否为 Bearer 鉴权。Dify 页面中通常只需要填写 `sk-` 开头的 Key 本身，不需要手动加 `Bearer `。

### 请求地址错误

如果报错里出现重复路径，例如 `/v1/v1/chat/completions` 或 `/chat/completions/chat/completions`，说明 API Base 填写过长。请改为：

```text theme={null}
https://gogogotoken.ai
```

### 工作流运行失败

优先检查三项：API Key 余额是否充足、模型是否在当前令牌分组内、Dify 应用是否选中了刚配置的模型供应商。