基础配置
本章节介绍插件使用前必须完成的基础信息配置。完成本章配置后，才能正常使用 AI 自动填写、图片翻译、AI 生图、自动定价、库存管理等功能。
配置优先级建议
如果你是第一次使用，建议按以下顺序配置：
1. 绑定 Ozon 店铺 → 2. 配置阿里云 API → 3. 配置生图 API（可选） → 4. 启用自动定价- 只想做基础采集和翻译：完成前 2 步即可。
- 需要 AI 生图：再完成第 3 步。
- 需要自动算价：再完成第 4 步。
一、绑定 Ozon 店铺
1.1 添加店铺
打开插件面板，点击“添加店铺”。
在弹出的配置窗口中填写店铺信息。
点击“保存”。
1.2 填写字段
绑定店铺需要填写两个字段：
- Client ID
- API Key
不要复制成 Ozon ID
Client ID 和 Ozon ID 是不同字段，请严格按照下方说明获取。
获取 Client ID
登录 Ozon Seller 后台。
点击右上角头像，选择“卖家 API”。
在 Seller API 页面找到 Client ID，复制该值。
TIP
页面上通常同时显示 Ozon ID 和 Client ID，请确认复制的是 Client ID 字段。
获取 API Key
在同一页面点击“生成 API 密钥”。
按提示填写密钥名称、用途、令牌类型后，点击“生成”。
复制生成的 API Key。
将 Client ID 和 API Key 填入插件对应位置，点击保存。
1.3 多店铺切换
如果你绑定了多个店铺，可以在以下位置切换当前使用的店铺：
- 上架店铺：在“上架”或“开始执行”页面顶部选择，决定商品上传到哪个店铺。
- 库存管理店铺：在“库存管理”页面选择，决定查询和修改哪个店铺的库存。
注意店铺区分
上架店铺和库存管理店铺可以不同，配置时务必确认当前选中的是哪个店铺。
二、店铺说明（重要）
2.1 上架店铺
“上架店铺”决定商品上传后进入哪个 Ozon 店铺。
2.2 库存管理店铺
“库存管理店铺”决定库存管理功能操作的是哪个店铺。
2.3 举例说明
| 场景 | 上架店铺 | 库存管理店铺 |
|---|---|---|
| 商品上传到百货 1，库存也管理百货 1 | 百货 1 | 百货 1 |
| 商品上传到百货 1，库存管理百货 2 | 百货 1 | 百货 2 |
| 商品上传到两个店铺 | 百货 1、百货 2 | 按需选择 |
2.4 建议
避免复制禁令
不要把同一套商品信息上架到多个店铺，容易违反复制禁令。
三、配置阿里云 API
AI 自动填写、图片翻译等功能依赖阿里云大模型服务。
3.1 注册阿里云账号
- 访问 阿里云百炼控制台。
- 使用支付宝账号登录并完成个人认证。
3.2 充值
首次使用建议充值 2 元即可试用。
TIP
阿里云图片翻译价格很便宜，正常约 3 元能翻译 1000 张图片。
后续如需大量使用，可购买套餐：阿里云 AI 优惠套餐
3.3 申请 API Key
进入 API Key 管理页面。
点击右上角“创建 API Key”。
确认创建后，复制生成的 API Key。
3.4 填入插件
打开插件面板，点击左上角“基础信息”。
找到“阿里云 API Key”输入框，粘贴刚刚复制的 API Key。
点击保存。
TIP
如果后续 AI 填写或图片翻译出现英文报错，通常说明阿里云 API Key 填写错误，或账户余额不足。
四、配置生图 API
AI 生图功能需要接入第三方生图服务。插件支持配置符合 OpenAI 兼容格式的大模型 API。
4.1 推荐方案
- 国内生图大模型（推荐）：如 Seedream 5.0、通义万相等国内服务，访问稳定、速度快，适合日常商品图生成。
- 国际版本 API（可选）：如需更高画质或特殊风格，可配置 OpenAI GPT Image、Midjourney API、Google Gemini Nano Banana、Stable Diffusion 等海外服务。
- 中转平台（谨慎选择）：如果你使用的是第三方 API 中转平台，请务必选择合法合规的服务商，并自行确认其稳定性与费用规则。
合规声明
使用本插件接入任何第三方 API 时，你必须确保：
- 生成内容符合所在国家/地区的法律法规；
- 使用方式不侵犯他人知识产权、肖像权或隐私权；
- 不生成违法、违规、侵权或不当内容。
本插件仅提供工具能力，不对第三方 API 的内容安全、服务稳定性、费用及合规性负责。因使用第三方 API 产生的任何法律责任，由用户自行承担。
4.2 添加到插件
在插件基础信息页面，找到“AI 生图配置”，点击“新增”。
填写以下字段：
- Base URL：粘贴服务商提供的 Base URL
- 生图 API：粘贴你的 API 密钥
点击保存。
4.3 获取 API 信息
- 在你选择的生图服务平台注册账号。
- 进入 API 管理页面，创建 API 密钥。
- 复制以下信息：
- Base URL：服务商提供的基础接口地址
- API Key：你的 API 密钥
TIP
具体平台推荐后续补充，当前可先留空，后续版本会提供推荐服务商列表。
4.4 切换分组与充值
- 如需切换生图分组，可在插件配置中选择对应分组。
- 如果提示欠费，前往对应服务商后台充值。
4.5 异步任务说明
- 生图任务为异步执行，超时后可点击“恢复”重新获取结果。
- 重新获取不会二次扣费。
- 只要服务商后台没有提示失败，最终都可以通过“恢复”拿到结果。
五、配置象寄（可选）
象寄主要用于精细化处理图片，例如精修主图。注册后有免费张数可以使用。
5.1 注册象寄账号
访问 象寄注册页面 注册。
5.2 获取信息
- 注册后登录，点击右上角“账户信息”。
- 复制以下两个字段：
- 私人密钥
- 图片翻译下的阿里标识码
5.3 填入插件
在插件基础信息页面找到“象寄配置”，粘贴对应字段后保存。
六、启用自动定价模板
配置完成后，勾选“启用自动定价模板”。
6.1 可以自动生成价格的情况
商品详情页必须包含完整的包装尺寸和重量信息。
6.2 不能自动生成价格的情况
| 情况 | 说明 | 处理方式 |
|---|---|---|
| 没有包装尺寸 | 缺少完整尺寸信息 | 手动填写后，自动定价会重新计算 |
| 尺寸超限 | 单边超过 150 cm，或两边超过 50 cm | 系统无法计算，需手动定价 |
6.3 自动定价效果
- 开启自动定价后，插件会根据尺寸、重量和物流规则自动计算价格。
- 未开启自动定价时，价格字段为空，需要手动填写。
TIP
为防止大件商品入库时物流扫描尺寸增加，自动计算价格时会为每个边增加约 1–2 cm 的余量。
七、清除缓存
如果你发现任务卡住、进度异常或想重新开始当前任务，可以清除缓存：
- 在插件面板中点击“清除缓存”。
- 确认弹窗提示后，插件会清除当前任务进度并重置状态。
- 刷新当前商品详情页，重新打开插件面板。
注意
清除缓存会删除当前任务进度，无法恢复。请确认不需要保留当前进度后再操作。
八、配置检查清单
配置完成后，请逐项确认：
- [ ] 已安装插件并激活
- [ ] 已添加 Ozon 店铺，Client ID 和 API Key 正确
- [ ] 已配置阿里云 API Key 且已充值
- [ ] 如使用 AI 生图，已配置生图 API 服务
- [ ] 已根据需求启用或关闭自动定价模板
- [ ] 已确认上架店铺和库存管理店铺的区别
九、配置失败排查
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 保存配置后提示失败 | API Key 格式错误 | 检查是否有空格或多余字符 |
| 店铺保存后无法查询 | Client ID 或 API Key 错误 | 重新到 Ozon 后台复制 |
| 自动定价未生效 | 未开启开关或缺少尺寸 | 检查开关状态和商品信息 |
| 生图提示欠费 | 生图 API 余额不足 | 到服务商后台充值 |
下一步：上架操作