登录/注册
Chatbox 接入教程
推荐工具更新时间：2025-11-26产品简介
Chatbox 是一款跨平台的 AI 客户端应用和智能助手，让您无需配置复杂的开发环境即可直接与大模型进行对话交互。通过 Chatbox，您可以：
- 🚀 快速接入海鲸AI提供的200+种AI模型
- 💰 按需付费，无需订阅，用多少付多少
- 🔄 兼容 OpenAI API，无缝切换不同模型
- 🖥️ 全平台支持，Windows、macOS、Linux 及网页版
前置准备
在开始使用前，请确保：
- ✅ 已获取海鲸AI平台的 API Key (如何获取API Key)
- ✅ 已确认账户余额充足，可正常调用模型服务
- ✅ 已在模型列表中选择您需要使用的文本生成模型
温馨提示
由于 Chatbox 的功能可能随版本更新，模型的实际支持情况请以客户端实际效果为准。
使用步骤
1. 下载安装 Chatbox
访问 Chatbox 官网，根据您的设备系统（Windows/macOS/Linux）下载并安装对应版本，或直接使用网页版。
| 平台 | 下载方式 | 备注 |
|---|---|---|
| Windows | 下载 .exe 安装包 | 支持 Windows 10+ |
| macOS | 下载 .dmg 安装包 | 支持 macOS 11+ |
| Linux | 下载 AppImage | 支持主流发行版 |
| 网页版 | 在线使用 | 无需安装 |
2. 配置海鲸AI模型服务
2.1 添加自定义提供方
- 单击 Chatbox 页面左下角的 设置 图标
- 选择 模型提供方 选项
- 单击底部的 添加 按钮
- 在弹窗中进行配置：
- 名称：输入 "海鲸AI" 或 "HaiJing AI"
- API 模式：选择 "OpenAI API 兼容"
- 单击 添加 完成创建
2.2 配置 API 参数
| 配置项 | 说明 | 示例 |
|---|---|---|
| API 密钥 | 填入您在海鲸AI平台获取的 API Key | sk-xxxxxxxxxxxxxxxx |
| API 主机 | 填入海鲸AI的 API 地址 | https://api.atalk-ai.com |
| API 路径 | 无需填写 | /v2/chat/completions |
| 模型 | 单击 新建，填入模型ID | gpt-4o 等 |
常用模型推荐
- GPT-4 Turbo -
gpt-4-turbo- 最强大的通用模型 - Claude 4.5 Opus -
claude-opus-4.5- 卓越的推理能力 - GPT-4o -
gpt-4o- 性价比之选 - 通义千问 -
qwen-turbo- 中文优化模型
查看完整模型列表
重要提示
不同模型支持的功能不同，请根据模型列表中的具体说明勾选 推理 与 工具使用 功能。
2.3 对话参数设置
完成基础配置后，单击设置页面左侧的 对话设置，调整以下参数：
| 参数 | 说明 | 建议值 |
|---|---|---|
| 上下文消息数量上限 | 每次提问时携带的历史对话轮数 | 5-10（日常对话） 过多可能导致超出模型上下文限制 |
| 温度 (Temperature) | 控制生成文本的随机性和创造性 • 较高：更多样化，适合创作、头脑风暴 • 较低：更确定，适合代码、数学推理 | 0.7-1.0（创作） 0.1-0.5（精确任务） 必须 < 2 |
| Top P | 与温度类似，控制生成多样性 | 必须 ≤ 1 |
3. 开始对话
配置完成后，在对话框中输入您的问题即可开始与 AI 对话。
支持的输入类型
| 类型 | 支持情况 | 说明 |
|---|---|---|
| 📝 文本消息 | ✅ 支持 | 所有模型均支持 |
| 🖼️ 图片 | ✅ 支持 | 需使用视觉理解模型（如 GPT-4V、Claude 3） |
| 📄 文档文件 | ✅ 支持 | 支持 PDF、TXT、Markdown 等格式 |
| 🎥 视频/音频 | ❌ 暂不支持 | 即将推出 |
示例对话
markdown
👤 用户：你是谁？
🤖 AI：我是一个由海鲸AI平台提供服务的人工智能助手，
可以帮助您解答问题、处理文档、进行创作等多种任务。高级功能
部分支持推理能力的模型（如 Qwen3 系列、o1 系列）可以展示详细的思考过程，帮助您理解 AI 的推理逻辑。
常见问题
Q1：如何计费？
海鲸AI采用按 Token 计费模式，对模型输入与输出的 Token 分别计费。具体价格请参见价格说明。
节省 Token 的建议：
- 多轮对话会累积历史记录，消耗较多 Token
- 可通过新建对话或降低"上下文消息数量上限"来减少消耗
- 日常聊天建议设置 5-10 轮上下文
Q2：连接失败怎么办？
错误：Range of input length should be [1, xxx]
原因：输入内容或累积上下文超出模型最大长度限制
解决方案：
首次对话即报错：
- 减少输入文本长度
- 缩小上传文件大小
- 使用支持更长上下文的模型
多轮对话后报错：
- 新建对话清空历史记录
- 减少"上下文消息数量上限"
- 切换至长上下文模型
错误：Access denied, please make sure your account is in good standing
原因：账户状态异常
解决方案：
- 检查账户是否欠费
- 确认 API Key 是否有效
- 检查 API Key 是否有相应模型的调用权限
错误：'temperature' must be Float 或 'top_p' is greater than the maximum of 1
原因：参数设置不符合规范
解决方案：
- 温度 (Temperature) 必须 < 2
- Top P 必须 ≤ 1
Q3：传入图片和文档有什么限制？
| 文件类型 | 限制说明 |
|---|---|
| 图片 | • 仅支持视觉理解功能的模型 • 建议格式：JPG、PNG、WebP • 单张大小建议 < 5MB • 分辨率建议 < 4096×4096 |
| 文档 | • Chatbox 会自动解析文档内容为文本 • 解析后的文本 Token 数不能超过模型上下文限制 • 支持格式：PDF、TXT、Markdown 等 |
Q4：如何优化使用体验？
性能优化建议
选择合适的模型
- 简单任务使用 GPT-4o-mini
- 复杂推理使用 GPT-4o 或 Claude 4.5 Opus
- 中文任务优先选择通义千问、文心一言等
调整参数设置
- 创意写作：Temperature 0.8-1.0
- 代码生成：Temperature 0.2-0.4
- 事实问答：Temperature 0.1-0.3
管理对话历史
- 定期清空无关对话
- 设置合理的上下文轮数（5-10）
- 使用多个对话窗口分类讨论
Q5：支持哪些高级功能？
Chatbox 通过海鲸AI支持以下高级功能：
- ✅ Function Calling - 让 AI 调用外部工具
- ✅ JSON Mode - 结构化输出
- ✅ Vision - 图像理解和分析
- ✅ Streaming - 实时流式响应
- ✅ 多模态 - 文本、图像混合输入
查看完整功能列表