（14691期）Shopee-店铺媒体空间 – Shopee官方图片视频上传专家

Shopee官方图片视频上传专家 LinkFox官方出品，完整封装Shopee MediaSpace 6大API，支持商品图片直传与视频分片上传，为跨境卖家提供合规高效的官方媒体托管能力。 使用说明 核心用法 本技能是 LinkFox 官方开发的 Shopee 媒体上传工具，完整对接 Shopee Open Platform MediaSpace 模块的 6 个核心接口：initvideoupload（初始化视频上传）、uploadvideopart（分片上传）、completevideoupload（完成上传）、getvideouploadresult（查询结果）、cancelvideoupload（取消上传）以及 uploadimage（图片上传）。 调用链路通过 POST /shopee/developerProxy 实现，需先依赖 linkfox-shopee-store-auth 完成店铺授权，由服务端自动注入 token 转发请求。支持两种使用模式：Python 脚本直调（python scripts/mediaspaceapi.py）或通用 JSON 接口调用。图片上传即时返回 Shopee 官方 URL，可直接用于商品 listing；视频上传采用分片机制，适配大文件场景，流程为初始化→循环分片→完成确认→结果查询。 输出策略兼顾完整性与性能：响应体 ≤8KB 时全量打印，>8KB 时输出摘要（顶层字段、计数、前3条样本），同时强制落盘至项目目录 linkfox/<日期>/<session>/data/ 路径，便于后续用 jq 等工具按需提取。 显著优点 官方合规性：直接对接 Shopee 官方 Open API，非模拟或爬虫方案，规避平台风控风险，上传的媒体资源获得官方 CDN 托管，稳定性与加载速度有保障。 工程化封装：提供 6 个单功能脚本 + 1 个通用入口，覆盖从初始化到结果查询的完整生命周期；内置 shopeemediaspacecommon.py 等共享模块，代码复用度高，降低二次开发成本。 与店铺生态深度整合：与 linkfox-shopee-store-auth（授权）、linkfox-shopee-store-product（商品 listing）、linkfox-shopee-store-video（视频发布）形成完整工作流，支持从媒体上传到商品上架的无缝衔接。 零积分消耗：明确标注不消耗积分，对高频上传操作的卖家友好，降低运营成本。 潜在缺点与局限性 强依赖前置授权：必须先完成 linkfox-shopee-store-auth 店铺授权，未配置或 token 过期时返回 exit code 42，无法独立运行，增加了初次使用门槛。 分片上传复杂度：视频上传需开发者自行处理分片循环、断点续传、错误重试等逻辑，技能本身仅提供原子接口，未内置高级封装（如自动分片、进度回调），对非技术用户不够友好。 网关与文件限制：大文件/二进制上传可能依赖网关 multipart 支持；未明确说明单文件大小上限、分片大小建议等工程细节，实际使用中可能需反复调试。 生态锁定：深度绑定 LinkFox 代理体系（紫鸟 shopee-proxy），若迁移至其他基础设施需重构调用链路。 适合的目标群体 跨境电商平台运营者：管理多店铺商品素材，需批量上传图片/视频至 Shopee 官方媒体库 ERP/工具开发商：集成 Shopee 媒体能力至自有系统，需官方合规 API 封装 技术型卖家：具备 Python 脚本能力，希望自动化商品素材管理流程 LinkFox 生态用户：已使用 LinkFox 系列 Shopee 技能（授权、商品、视频），希望补齐媒体上传环节 使用风险 认证与稳定性风险：token 有效期、店铺授权状态变更可能导致 401/402 错误；依赖 LinkFox 服务端代理，若代理服务异常将中断上传能力。 数据存储与隐私：上传文件流经 LinkFox 代理服务器，敏感商品素材存在第三方可见性；输出文件落盘至本地项目目录，多用户共享环境需注意路径隔离。 API 变更风险：Shopee Open Platform 接口升级（如 v2→v3）可能导致 path 或参数不兼容，需关注官方公告及时升级技能版本。 大文件传输风险：分片上传过程中网络中断可能导致脏数据残留，需配合 cancelvideoupload 及时清理；未内置幂等机制，重复调用可能产生冗余媒体资源。 原始说明 Shopee（虾皮）媒体上传 MediaSpace（与 linkfox-shopee-store-auth 同系列），经 /shopee/developerProxy 转发 Shopee Open API MediaSpace 模块全部 6 个接口：init_video_upload、upload_video_part、complete_video_upload、get_video_upload_result、cancel_video_upload、upload_image。当用户提到 Shopee 上传图片、上传视频、media_space、init_video_upload、upload_image、视频分片上传、获取Shopee图片URL 时触发。即使未明确提及"媒体"，只要涉及已授权 Shopee 店铺的图片/视频文件上传，也应触发。