# Coze 接入指南

扣子（Coze）是字节跳动推出的 AI 应用开发平台。本文介绍如何让它通过 UModelverse 平台调用模型。

> **注意：** 自定义模型接入需要升级至**个人进阶版及以上**套餐。

## **1. 获取 API Key**

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。可用模型见 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)。

## **2. 添加自定义模型**

1. 进入 Coze **模型管理**页面，点击右上角 **+ 接入模型**。

    ![Coze 模型管理页面](https://cdnv2-cache.udelivrs.com/2026/06/788cf87673a64384877265ce087b3266_1781261163458.png)

2. 在弹窗中切换到 **自定义接入** 标签页，按下表填写：

    ![Coze 自定义接入填写字段](https://cdnv2-cache.udelivrs.com/2026/06/1fd437ff772f601ea681343af6002006_1781261163463.png)

| 字段 | 填写值 |
| --- | --- |
| 模型展示名称 | 自定义名称，例如 `qwen3.7-max` |
| 模型 ID | UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，例如 `qwen3.7-max` |
| 模型协议 | 选择 **Chat API** |
| API URL | `https://api.modelverse.cn/v1` |
| API Key | 您的 UModelverse [API Key](https://console.ucloud.cn/modelverse/api) |
| 高级配置 - 图片理解 | 如需在对话中发送图片，勾选此项（仅支持视觉模型） |
| 高级配置 - 最大回复长度 | 根据模型支持的上下文长度选择，推荐 **64K** |

3. 点击 **添加**，即可在创建或编辑智能体/工作流时选用该模型。

## **常见问题**

### 调用模型报错认证失败或无法连接？

请逐项确认：

1. API Key 来自 UModelverse 平台，复制完整且无空格。

2. API URL 为 `https://api.modelverse.cn/v1`（带 `/v1`）。

3. 模型 ID 填写的是 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一，名称完全一致。