智赢选品 AI 配置（自备大模型 Key）使用说明
插件的 AI 核价、AI核价采集、Listing 优化等能力需要调用大模型完成理解与计算。插件本身不内置任何模型密钥，需要您在自己信任的大模型平台申请 API Key 后，在「AI 配置」页填写、测试并保存。本文以 DeepSeek 与阿里云百炼为例，演示从申请 Key 到配置生效的完整流程。
最低版本要求：v5.1.15
如果当前插件版本低于此版本，请先更新后再使用；更新地址：https://www.zying.net/amazon.html
入口一：点击浏览器右上角智赢插件图标，在弹出菜单中点「偏好设置」打开设置页，再在左侧菜单点「AI 配置」
功能说明
- AI 配置是什么：AI 核价、AI核价采集、Listing 优化等功能要靠大模型理解商品与计算价格。插件不内置密钥，需要您自备大模型平台的 API Key 并在本页配置后才能使用这些能力。
- 支持哪些厂商：DeepSeek、小米 MiMo、智谱 GLM、阿里云百炼（通义千问）、腾讯云混元、火山引擎（豆包），以及兼容 OpenAI / Anthropic 协议的自定义服务。
- 密钥存在哪里：配置仅保存在您本地浏览器中，不会上传到插件服务器。
- 配置好之后的效果：AI核价采集窗口右上角不再提示「AI未配置Key」，即可正常发起 AI 核价采集。
使用前准备
填写项说明
AI 服务厂商
下拉选择您要使用的模型平台。已有账号或余额的就选对应厂商；都没有可先选 DeepSeek 或阿里云百炼（新用户通常有免费额度）。若您的平台不在列表里，选「自定义(OpenAI/Anthropic)」。
接口协议 (Protocol)
决定插件用哪种通用格式与模型对话。绝大多数平台选「OpenAI 兼容协议 (默认)」即可；只有小米 MiMo、Claude 等明确提供 Anthropic 接口的平台才选「Anthropic 协议」。
API 请求地址 (Base URL)
插件向哪个网址发送请求。选择预设厂商后会自动填好官方地址，通常无需修改；只有使用代理、中转或私有部署时才改成自己的地址。改错会连接失败，可点「恢复为官方默认地址」还原。
API Key
模型平台发给您的访问密钥，相当于调用模型的「门票」，按量计费也记在它头上。必填，不填无法测试连接、也无法启用 AI 能力。下方「前往获取 …」链接可直接跳到对应平台的密钥管理页。
模型选择 (Model)
指定本次使用哪个模型。可直接输入模型名称，也可点右侧下拉从该厂商官方推荐模型里快捷填入；留空则使用厂商默认模型。火山引擎还支持填推理接入点 ID（形如 ep-2024xxxx）。自定义厂商必须手动填写。
测试连接 / 保存配置
「测试连接」会用当前填写的内容真实调用一次模型，验证 Key 与地址是否可用（未填 API Key 时按钮为灰色不可点）；「保存配置」把当前内容写入本地。测试连接前会自动先保存一次当前填写。
操作步骤
主线一：以 DeepSeek 为例（推荐新手）
打开「AI 配置」页
两种方式任选：① 点击浏览器右上角智赢插件图标，在弹出菜单中点「偏好设置」打开设置页，再在左侧菜单点「AI 配置」；② 在 AI核价采集窗口右上角点「AI未配置Key」或「配置Key」按钮直接跳转。打开后即为配置表单。
选择 AI 服务厂商
在「AI 服务厂商」下拉中选择 DeepSeek。选择后下方的请求地址会自动填好 DeepSeek 官方地址，模型下拉也会出现 DeepSeek 的推荐模型；表单中还会给出「前往获取 DeepSeek API Key」链接。
到 DeepSeek 平台创建并复制 API Key
点表单里「前往获取 DeepSeek API Key」链接进入 API keys 页，点「创建 API key」；在弹窗里给 Key 起个名字点「创建」；随后点「复制」拿到以 sk- 开头的密钥。注意：Key 只在创建时显示一次，请妥善保存。
回到插件回填 Key 与模型
把复制的 Key 粘贴到「API Key」输入框；在「模型选择」里直接输入模型名，或点右侧下拉选一个推荐模型（如 deepseek-v4-pro）。请求地址保持官方默认即可，无需改动。
测试连接并保存
点「测试连接」。若配置正确会出现绿色提示「连接成功！配置已自动保存，模型 [xxx] 响应正常」，此时配置已生效；再点「保存配置」做最终确认即可。
主线二：以阿里云百炼（通义千问）为例
在阿里云百炼创建并复制 Key 后回填
厂商选「阿里云百炼 (通义千问)」后，点「前往获取」链接进入百炼控制台；首页点「API Key」进入管理页，点「创建API-KEY」；在弹窗中点「复制」拿到以 sk- 开头的密钥，回到插件粘贴到「API Key」框并保存。请求地址使用插件自动填好的官方兼容地址即可。
结果说明
测试连接成功时，页面出现绿色提示「连接成功！配置已自动保存，模型 [模型名] 响应正常」，同时顶部弹出「AI 服务连接成功！配置已自动保存」；手动点「保存配置」成功时提示「AI 配置保存成功」。配置生效后，重新打开 AI核价采集窗口，右上角不再显示「AI未配置Key」，即可正常发起 AI 核价采集。
若测试失败，会出现红色提示并附上失败原因（如密钥无效、地址错误、网络异常）。此时当前填写同样已保存，但 AI 能力不可用，需按提示修正后重新测试。
注意事项
- 密钥安全：API Key 等同于您的账户消费凭证，只保存在本地浏览器；请勿截图外发或填到不可信网站，一旦泄露请立即到平台作废重建。
- 切换厂商不丢草稿：在多个厂商之间切换时，各自已填的 Key、地址、模型会保留，返回时仍在。
- 测试连接会先保存：点「测试连接」前插件会先自动保存当前填写内容，因此测试失败时保存的也是这份配置，修正后记得重新测试或保存。
- 自定义厂商：选「自定义」时必须自己填写请求地址与模型名，且协议需与地址匹配（OpenAI 地址配 OpenAI 协议，Anthropic 地址配 Anthropic 协议）。
- 火山引擎：模型框可填推理接入点 ID（形如 ep-2024xxxx），不一定填模型名。
- 多模态图片比对：若要在 AI核价采集中开启「商品图片比对（多模态）」，请选择支持视觉理解的模型。
- 换设备需重配：配置存于本地浏览器，更换电脑或重装浏览器后需重新填写。
常见问题
测试连接失败 / 连接异常怎么办？
现象：点「测试连接」后出现红色提示「连接失败: …」或「连接异常: …」。
最可能原因：API Key 复制不完整或已失效；请求地址被改错；模型名填错；或该平台账户欠费、无可用额度。
下一步：重新到平台复制完整 Key 粘贴；非自定义厂商点「恢复为官方默认地址」；模型改用下拉推荐值；到平台确认余额后重测。
保存成功但 AI核价仍提示「AI未配置Key」？
现象：已点保存，但 AI核价采集窗口右上角仍显示未配置。
最可能原因：保存的 Key 为空或测试未通过，配置未被启用；或该窗口是保存之前打开的旧页面。
下一步：回到 AI 配置页确认 Key 非空并点「测试连接」直到绿色成功；然后关闭并重新打开 AI核价采集窗口。
换电脑 / 重装浏览器后 Key 还在吗？
现象：新环境打开 AI 配置页，所有输入框是空的。
最可能原因：配置仅存本地浏览器，不随账号同步。
下一步：重新填写；若原 Key 找不回，到对应平台作废旧 Key 并新建一个再填。
我该选哪个厂商 / 哪个模型？
现象：面对多个厂商与模型，不知道如何选择。
最可能原因：各厂商计费方式与赠送额度不同，没有统一答案。
下一步：已有账号或余额的就选对应厂商；都没有可先选 DeepSeek 或阿里云百炼的新用户免费额度试用；模型优先用下拉推荐项；若需开启图片比对（多模态），请选支持视觉理解的模型。
浙公网安备 33010302001526号 
合作咨询 9:00-18:00
