MODEL SETUP / 模型配置
把 PixMind 接入咔哒
先完成文字连接,试答一条问题;需要读取应用画面时,再配置并验证图片识别。软件模式不需要皮卡。
先记住三个东西
- API Key:你的调用密钥,相当于模型服务的通行证。只填写在咔哒的密钥栏。
- 接口地址:模型服务的 API 地址,不是邀请链接,也不是图片生成网页。
- 模型 ID:从 API 模型目录复制的完整名称,不是会员套餐名。
1. 注册或登录 PixMind
- 点击上方邀请链接。它可能跳到 PixMind 图片创作页面,这是正常的;注册入口在页面右上角。
- 未登录时点击“免费开始”或“登录”。按页面提示选择手机号、邮箱或 Google 账号,完成注册及验证。已有账号直接登录。
- 保留同一个浏览器继续操作。不要把密码、验证码或密钥发给我们。
注册方式依据 PixMind 账户说明,如界面变化,以平台当前提示为准。
2. 进入 API 平台,创建密钥
- 在顶部找到 API Platform → API,或打开 PixMind API 平台。
- 点击“创建 API Key”或“打开 API Key 控制台”,进入 密钥管理页。若提示登录,完成登录后重新打开此入口。
- 按控制台提示创建供咔哒使用的密钥,建议备注“咔哒内测”。复制完整密钥;官方示例前缀为
pm_live_,示例本身不能使用。 - 核对账号是否有 API 可用额度、目标模型权限;如果控制台提供预算与限流设置,先设小额预算。不要仅凭网页会员或积分余额判断 API 一定可调用。
需要充值时先看 API 控制台的额度与计费说明,小额验证成功后再决定用量;咔哒授权费与模型调用费是两件事。不要为了测试接口先购买大额套餐。
3. 在咔哒配置回复模型
进入 系统与硬件设置 → 回复生成模型(独立配置)。直接填写下表;不需要找名为 PixMind 的预设。
| 咔哒里的字段 | 填写内容 |
|---|---|
| 接口地址 / Base URL | https://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 后面,咔哒会追加接口路径。
- 点击 保存并测试文字连接,等待明确的成功提示。
- 去“业务知识库 → 新手上手与试答”,使用一份已审核启用的产品资料,问一个真实业务问题。
- 核对答案与参考资料。这一步只做试答,不发送给客户。
文字测试成功只证明文字接口连通,不等于画面识别或自动发送成功。更换服务商时应同时核对地址、模型与密钥;留空密钥会保留旧值。
4. 需要看画面,再配置图片识别
在同一设置页找到 画面识别模型,服务地区选“国际”,服务商选 其他国际视觉服务,接口地址与密钥仍填上面这套 PixMind 配置。模型必须在 API 模型目录 标明支持“图片输入/视觉理解”。
即使模型名字含 Gemini,也不要选择“Google Gemini”预设:该预设走 Google 原生协议,PixMind 此处使用 OpenAI 兼容协议。纯文字模型以及文生图、文生视频模型都不能替代截图理解模型。
- 点击 保存并测试图片识别。咔哒会发送软件生成的数字卡片,不读取聊天记录,也不需要皮卡。
- 只有返回正确识别结果,才继续在有权测试的窗口里核对真实画面的对象与文字。
- 在持续回复设置中核对当前使用哪套回复模型。文字和视觉分别保存,不能把一边的成功当作另一边已配置。
当前需要验证的一点
PixMind 公开快速开始说明图片素材使用 HTTPS 地址;咔哒截图使用内嵌图片数据。我们尚未完成这条图片输入方式的真实账号兼容验证。
如果出现“图片地址不支持”或图片测试失败,先保留可用的文字模型,用已验证的其他视觉服务。不要把客户截图上传到公开图床来绕过错误。把错误码与发生时间交给内测负责人核验。
5. 第一次成功后,怎么使用
- 先导入并审核一份自己的资料,试答产品、价格、售后三类问题;参考 知识库导入教程。
- 从“私域副驾”粘贴一个客户问题,生成并核对草稿,确认语气和报价符合你的业务。
- 需要操作应用时,再完成窗口、接待范围和执行模式设置;本轮自动发送只做有人值守的小范围测试。
- 到 PixMind API 控制台查看调用和消耗。回复越长、发送的资料和图片越多,成本可能越高;具体按所选模型的计费项计算。
连接失败时,按这个顺序排查
| 提示 | 处理方法 |
|---|---|
| 401/认证失败 | 重新复制完整 PixMind API Key,去掉空格;核对是否填成别家密钥、密码或邀请码。 |
| 403/无权限 | 检查密钥权限、账号及模型是否开通,以平台返回说明为准。 |
| 402/余额或付费提示 | 检查 API 可用额度与该模型计费;不要只看网页会员状态。 |
| 404/模型或路径不存在 | 检查 Base URL 是否完整、有无重复 /v1 或 /chat/completions,再从模型目录复制完整 ID。 |
| 429/限流 | 按平台提示等待,核对配额和请求频率,不连续点击测试。 |
| 超时/网络错误 | 先检查网络和平台状态,稍后重试一次;持续失败时保留时间与错误码。 |
| 文字成功、图片失败 | 核对视觉模型能力、OpenAI 兼容选项及图片输入格式;参考上面的兼容验证说明。 |
需要协助时
提供咔哒版本、失败时间、文字或图片测试、模型 ID、错误码与已遮挡密钥的截图。不要发送 API Key、完整配置目录、客户聊天或含隐私的工作区备份。
从 trial.95 开始,点击软件顶部或副驾的“帮助与日志 → 复制诊断日志”,粘贴发给负责人即可;也可保存为文本文件。日志不会自动上传,不含密钥、聊天和知识正文。不要把工作区备份当错误日志发到群里。