---
title: Chatbox 一键导入与配置
description: 通过 API Key 页面导入 Chatbox，核对 API Host、路径、模型和密钥。
---

<aside className="docs-publication" data-pagefind-ignore>文档由 <a href="https://1zheai.com/editorial/#publisher">1折AI</a> 维护。<a href="https://1zheai.com/editorial/">来源、商业关系与纠错说明</a>。发现错误，请向 <a href="mailto:support@1zheai.com">support@1zheai.com</a> 提供页面地址与可核查依据，不要发送密钥或账号资料。</aside>

Chatbox 1.15.1 起支持提供方 JSON 与 `chatbox://provider/import`。桌面版需先安装并启动一次。网页版或没有注册协议的系统，请使用剪贴板导入。

## 一键导入

1. 打开控制台的 **API 密钥**，找到要使用的密钥，进入 **使用工具 → Chatbox**。
2. 选择此密钥可用的聊天模型，再点 **打开 Chatbox**，允许浏览器打开应用。
3. 在 Chatbox 确认导入，检查服务商地址及模型。已有同名配置时，先核对覆盖范围。
4. 发送一条简短消息，在本站调用日志核对模型和请求时间。

## 剪贴板与手动配置

如果没有唤起应用，在同一面板复制 **Chatbox JSON**，到 Chatbox 设置中的服务商管理选择从剪贴板导入。分享给他人前必须删除 `settings.apiKey`。

| 字段 | 值 |
| --- | --- |
| 类型 | OpenAI API compatible |
| API Host | `https://1zheai.com` |
| API Path | `/v1/chat/completions` |
| API Key | 当前密钥 |
| Model ID | 当前密钥可用的聊天模型 |

Host 与 Path 分开填，不要将 `/v1` 同时加进两个字段。没有模型时先获取模型列表或手动添加；图像、嵌入、工具调用等能力需分别验证，不要把任意模型当作聊天模型。

## 排错

- 未弹出应用：确认安装、启动过应用，解除浏览器对此协议的阻止，或使用剪贴板导入。
- 导入后 401：检查密钥是否有效、有无空格。
- 404：确认最终路径为 `/v1/chat/completions`，未重复拼接。
- 模型不存在：改用模型列表中确切的 ID；不要根据显示昵称猜测。

官方：[配置导入协议](https://docs.chatboxai.app/guides/providers/import-config)、[客户端源码](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts)。

<Note>协议与官方资料核对于 2026-10-19。本站已实现配置生成与前端回归测试；未完成所有客户端、系统和模型的真实推理验证。客户端升级后请重新验证。自定义接入不代表官方合作或内置推荐。</Note>

更多：[API 密钥](/docs/api-keys/)、[模型列表](/docs/models/)、[调用日志](/docs/usage-logs/)、[地址说明](/docs/base-url/)。