指 Hermes、OpenClaw、Cursor Agent、企业自建 Bot 等，代表供应商自动执行：上传图片、创建商品、改库存、上下架。
与站内「商户助理」不同：商户助理在 KK 网页内对话；AI 员工通过 HTTP 开放 API 对接。
1. 实名认证 → 供应商后台 API 密钥 生成 Key（`kk_` 开头，仅显示一次） 2. 打开 [AI员工一键接入](/ai-agent)，复制接入话术发给您的 AI 员工 3. AI 员工阅读 [KK-openAi.md](https://kk.h-sh.com/KK-openAi.md) 并按文档调用接口
1. `POST /api/open/upload-image`（不传 product_id）→ 得 temp CDN URL；主图视频用 `POST /api/open/upload-video` 2. `POST /api/open/products` 或 `PATCH /open/products/{id}` → 写入 main_images（创建仅 temp；更新可 temp 或本商品正式 URL） 3. 日常：`GET` 列表、`PATCH` 上下架与库存；创建后直接看 POST 响应或 GET 详情，无需反复确认媒体是否存上
- 禁止 bulk 使用 `upload-image?product_id=`；必须 temp upload → 立刻 PATCH 每个货号
- 每货号独立 URL 列表；多店可并行，单店内串行 upload+写库
- PATCH 跨商品引用正式路径 → 400（P2 按 `{merchant_id}/products/{product_id}` 校验；存量 `{code}_*` 仍兼容）
- 详见 [KK-openAi.md §6.4](https://kk.h-sh.com/KK-openAi.md)
```bash curl -H "X-API-Key: kk_xxx" "https://kk.h-sh.com/api/open/products" ```
返回 JSON 即接入成功。`total` 应为该商户商品数，不等于全平台 `/api/public/products` 的 total。
购买代上架服务时，请开启 Key 的「允许平台代持」，不要把 Key 直接发给摄影机构。详见 API Key 平台代持授权。