> ## 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.

# n8n 配置

> 在 n8n 中配置 OpenAI 兼容凭证并调用 gogogotoken API

本页介绍如何在 n8n 中配置 gogogotoken，用于工作流自动化、文本生成、Agent 节点和 HTTP 请求节点。

## 推荐方式

优先使用 n8n 内置的 OpenAI 凭证或 OpenAI Chat Model 节点，并将 Base URL 指向 gogogotoken 的 OpenAI 兼容接口。

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

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

  <Card title="Chat Endpoint" icon="message-square">
    `/chat/completions`
  </Card>

  <Card title="鉴权方式" icon="shield-check">
    Bearer Token
  </Card>
</CardGroup>

## 方式一：OpenAI 节点

<Steps>
  <Step title="创建 API Key">
    进入控制台的 [令牌管理](/billing/api-key-management)，创建一个用于 n8n 的专用令牌。
  </Step>

  <Step title="新建 OpenAI 凭证">
    在 n8n 中打开 `Credentials`，新建 OpenAI 相关凭证。

    如果页面支持自定义 Base URL，请填写：

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

    API Key 填写你在控制台中复制的 `YOUR_API_KEY`。
  </Step>

  <Step title="添加 OpenAI Chat Model 节点">
    在工作流中添加 OpenAI Chat Model、OpenAI 或 AI Agent 相关节点。

    模型名称填写当前令牌可用的模型 ID，例如：

    ```text theme={null}
    gpt-4o
    ```
  </Step>

  <Step title="执行测试">
    运行节点，输入一条简单提示词：

    ```text theme={null}
    用三点说明自动化工作流的价值。
    ```

    节点成功返回内容后，就可以继续接入后续自动化步骤。
  </Step>
</Steps>

<Tip>
  如果你的 n8n 版本没有在 OpenAI 凭证里暴露 Base URL，可以使用下面的 HTTP Request 节点方式。
</Tip>

## 方式二：HTTP Request 节点

当内置 OpenAI 节点不支持自定义地址，或你希望更精确控制请求体时，可以直接使用 HTTP Request 节点调用接口。

<Steps>
  <Step title="添加 HTTP Request 节点">
    在工作流中添加 `HTTP Request` 节点，并设置：

    | 配置项               | 值                                            |
    | ----------------- | -------------------------------------------- |
    | Method            | `POST`                                       |
    | URL               | `https://gogogotoken.ai/v1/chat/completions` |
    | Send Headers      | `true`                                       |
    | Send Body         | `true`                                       |
    | Body Content Type | `JSON`                                       |
  </Step>

  <Step title="设置请求头">
    添加以下请求头：

    | Header        | Value                 |
    | ------------- | --------------------- |
    | Authorization | `Bearer YOUR_API_KEY` |
    | Content-Type  | `application/json`    |
  </Step>

  <Step title="填写请求体">
    使用下面的 JSON 作为请求体：

    ```json theme={null}
    {
      "model": "gpt-4o",
      "messages": [
        {
          "role": "user",
          "content": "用三点说明自动化工作流的价值。"
        }
      ],
      "stream": false
    }
    ```
  </Step>

  <Step title="读取模型输出">
    非流式返回中，模型文本通常位于：

    ```text theme={null}
    choices[0].message.content
    ```

    你可以在后续节点中引用这个字段继续处理。
  </Step>
</Steps>

## 常见问题

### OpenAI 节点无法填写 Base URL

换用 `HTTP Request` 节点直接调用 `https://gogogotoken.ai/v1/chat/completions`。

### 返回模型无权限

调用 [模型列表](/overseas/models) 确认当前 API Key 可访问的模型。模型不在列表中时，需要更换模型或调整令牌分组权限。

### HTTP Request 返回 401

检查 `Authorization` 请求头是否为：

```text theme={null}
Bearer YOUR_API_KEY
```

注意这里需要包含 `Bearer` 前缀。

### 工作流偶发失败

建议在 n8n 节点中配置重试策略，并根据业务场景控制并发。批量自动化任务也建议使用独立 API Key，方便统计和限流。