跳到正文
← 返回上手指南

MODEL SETUP / 模型配置

把 PixMind 接入咔哒

先完成文字连接,试答一条问题;需要读取应用画面时,再配置并验证图片识别。软件模式不需要皮卡。

更新于 2026-09-27 · 按 PixMind 官方公开文档及咔哒设置界面编写。本文不代表已用你的账号完成实测,实际可用模型与费用以控制台为准。

到对应模型平台申请 API Key。

已有密钥,直接看配置

先记住三个东西

1. 注册或登录 PixMind

  1. 在浏览器里打开 PixMind 官网,注册入口在页面右上角。
  2. 未登录时点击“免费开始”或“登录”。按页面提示选择手机号、邮箱或 Google 账号,完成注册及验证。已有账号直接登录。
  3. 保留同一个浏览器继续操作。不要把密码、验证码或密钥发给我们。

注册方式依据 PixMind 官方的账户说明,如界面变化,以平台当前提示为准。

2. 进入 API 平台,创建密钥

  1. 在顶部找到 API Platform → API,或在 PixMind 网站上打开“API 平台”。
  2. 点击“创建 API Key”或“打开 API Key 控制台”,进入“密钥管理”页。若提示登录,完成登录后重新打开此入口。
  3. 按控制台提示创建供咔哒使用的密钥,建议备注“咔哒”。复制完整密钥;官方示例前缀为 pm_live_,示例本身不能使用。
  4. 核对账号是否有 API 可用额度、目标模型权限;如果控制台提供预算与限流设置,先设小额预算。不要仅凭网页会员或积分余额判断 API 一定可调用。

需要充值时先看 API 控制台的额度与计费说明,小额验证成功后再决定用量;咔哒授权费与模型调用费是两件事。不要为了测试接口先购买大额套餐。

3. 在咔哒配置回复模型

进入 系统与硬件设置 → 回复生成模型(独立配置)。直接填写下表;不需要找名为 PixMind 的预设。

咔哒里的字段填写内容
接口地址 / Base URLhttps://aihub-admin.aimix.pro/api-platform/v1
回复生成模型名称gemini-3.5-flash
这是 PixMind 快速开始的示例 ID。使用前在模型目录核对账号当前可用;也可换成其他已开通的文字模型 ID。
回复生成 API Key刚才从 PixMind 创建的完整密钥,不加 Bearer ,不加引号。
温度第一次保留咔哒默认值。

地址看起来不是 pixmind.io?上表是 PixMind 官方快速开始当前列出的 API 服务地址。不要自行替换域名,也不要把 /chat/completions 再拼到 Base URL 后面,咔哒会追加接口路径。

  1. 点击 保存并测试文字连接,等待明确的成功提示。
  2. 去“业务知识库 → 新手上手与试答”,使用一份已审核启用的产品资料,问一个真实业务问题。
  3. 核对答案与参考资料。这一步只做试答,不发送给客户。

文字测试成功只证明文字接口连通,不等于画面识别或自动发送成功。更换服务商时应同时核对地址、模型与密钥;留空密钥会保留旧值。

4. 需要看画面,再配置图片识别

在同一设置页找到 画面识别模型,服务地区选“国际”,服务商选 其他国际视觉服务,接口地址与密钥仍填上面这套 PixMind 配置。模型必须在 PixMind 的“API 模型目录”里标明支持“图片输入/视觉理解”。

即使模型名字含 Gemini,也不要选择“Google Gemini”预设:该预设走 Google 原生协议,PixMind 此处使用 OpenAI 兼容协议。纯文字模型以及文生图、文生视频模型都不能替代截图理解模型。

  1. 点击 保存并测试图片识别。咔哒会发送软件生成的数字卡片,不读取聊天记录,也不需要皮卡。
  2. 只有返回正确识别结果,才继续在有权测试的窗口里核对真实画面的对象与文字。
  3. 在持续回复设置中核对当前使用哪套回复模型。文字和视觉分别保存,不能把一边的成功当作另一边已配置。

当前需要验证的一点

PixMind 公开快速开始说明图片素材使用 HTTPS 地址;咔哒截图使用内嵌图片数据。我们尚未完成这条图片输入方式的真实账号兼容验证。

如果出现“图片地址不支持”或图片测试失败,先保留可用的文字模型,用已验证的其他视觉服务。不要把客户截图上传到公开图床来绕过错误。把错误码与发生时间交给客服核验。

5. 第一次成功后,怎么使用

  1. 先导入并审核一份自己的资料,试答产品、价格、售后三类问题;参考 知识库导入教程。
  2. 从“私域副驾”粘贴一个客户问题,生成并核对草稿,确认语气和报价符合你的业务。
  3. 需要操作应用时,再完成窗口、接待范围和执行模式设置;本轮自动发送只做有人值守的小范围测试。
  4. 到 PixMind API 控制台查看调用和消耗。回复越长、发送的资料和图片越多,成本可能越高;具体按所选模型的计费项计算。

连接失败时,按这个顺序排查

提示处理方法
401/认证失败重新复制完整 PixMind API Key,去掉空格;核对是否填成别家密钥、密码或邀请码。
403/无权限检查密钥权限、账号及模型是否开通,以平台返回说明为准。
402/余额或付费提示检查 API 可用额度与该模型计费;不要只看网页会员状态。
404/模型或路径不存在检查 Base URL 是否完整、有无重复 /v1 或 /chat/completions,再从模型目录复制完整 ID。
429/限流按平台提示等待,核对配额和请求频率,不连续点击测试。
超时/网络错误先检查网络和平台状态,稍后重试一次;持续失败时保留时间与错误码。
文字成功、图片失败核对视觉模型能力、OpenAI 兼容选项及图片输入格式;参考上面的兼容验证说明。

需要协助时

提供咔哒版本、失败时间、文字或图片测试、模型 ID、错误码与已遮挡密钥的截图。不要发送 API Key、完整配置目录、客户聊天或含隐私的工作区备份。

下载反馈模板联系客服

新版本起,点击软件顶部或副驾的“帮助与日志 → 复制诊断日志”,粘贴发给负责人即可;也可保存为文本文件。日志不会自动上传,不含密钥、聊天和知识正文。不要把工作区备份当错误日志发到群里。

平台官方资料

都在 PixMind 官网的文档里:

继续上手指南 → · 返回下载页