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

# Coze 配置

> 在 Coze 或 Coze Studio 中通过 OpenAI 兼容模型服务接入 gogogotoken API

本页介绍如何在 Coze / Coze Studio 中配置 OpenAI 兼容模型服务，并使用 gogogotoken 提供的模型能力。

<Note>
  Coze 不同版本和部署形态的菜单名称可能略有差异。本文以“添加 OpenAI 兼容模型服务”的通用流程为准：核心是填写 API Key、Base URL 和模型 ID。
</Note>

## 接入参数

| 配置项             | 填写内容                                   |
| --------------- | -------------------------------------- |
| Provider / Type | `OpenAI Compatible` 或 `OpenAI`         |
| API Key         | `YOUR_API_KEY`                         |
| Base URL        | `https://gogogotoken.ai/v1`            |
| Model ID        | 例如 `gpt-4o`、`claude-sonnet-4-20250514` |

<Warning>
  Base URL 建议填写到 `/v1`。不要把 `/chat/completions` 写进 Base URL。
</Warning>

## 配置步骤

<Steps>
  <Step title="准备 API Key 和模型 ID">
    进入控制台的 [令牌管理](/billing/api-key-management)，创建或复制一个可用令牌。

    然后通过 [模型列表](/overseas/models) 确认当前令牌可访问的模型 ID。
  </Step>

  <Step title="进入模型服务配置">
    在 Coze / Coze Studio 中进入模型、模型服务或资源配置页面。

    添加新的模型服务时，选择 `OpenAI Compatible`、`OpenAI API Compatible` 或类似的 OpenAI 兼容接入方式。
  </Step>

  <Step title="填写服务地址和鉴权信息">
    按下面方式填写：

    ```text theme={null}
    API Key: YOUR_API_KEY
    Base URL: https://gogogotoken.ai/v1
    ```

    如果页面要求填写模型名称或模型 ID，请填写你要使用的模型，例如：

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

  <Step title="保存并测试连通性">
    保存模型服务后，使用页面内的测试功能发送一条短消息。

    如果 Coze 返回模型回复，说明服务已经配置成功。
  </Step>

  <Step title="在 Bot 或 Agent 中选择模型">
    回到 Bot、Agent 或工作流编排页面，将默认模型切换为刚刚添加的模型服务。

    如果同一个 Bot 中有多个节点调用模型，请逐个检查节点使用的模型配置。
  </Step>
</Steps>

## 推荐配置

<CardGroup cols={2}>
  <Card title="日常 Bot" icon="message-circle">
    使用 `gpt-4o` 或其他通用对话模型。
  </Card>

  <Card title="复杂 Agent" icon="brain">
    使用 `claude-sonnet-4-20250514` 等更适合推理和长上下文的模型。
  </Card>
</CardGroup>

## 调试建议

### 模型测试成功，但 Bot 不生效

检查 Bot 当前发布版本是否已经选择新模型。有些 Coze 环境需要重新发布或重新运行调试会话后才会使用新配置。

### 返回 401 或鉴权失败

重新复制 API Key，确认没有多余空格。Coze 配置页通常只填写 Key 本身，不需要填写 `Bearer` 前缀。

### 返回 404 或路径不存在

检查 Base URL 是否为：

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

不要填写到 `https://gogogotoken.ai/v1/chat/completions`。

### 返回 403 或模型无权限

确认当前 API Key 的分组权限包含目标模型。可以先调用 [模型列表](/overseas/models) 验证模型是否出现在返回结果中。