（14751期）TikTok官方-带货视频API – TikTok视频号运营自动化中枢

TikTok视频号运营自动化中枢 基于LinkFox网关与紫鸟代理的官方TikTok创作者开放接口，实现达人授权后的视频上传、预检、发布、状态追踪及选品挂车全链路自动化，助力跨境内容电商高效运营。 使用说明 核心用法 本Skill为TikTok视频号（Creator/ Affiliate）业务专用API代理层，经LinkFox网关/tiktokVideo/developerProxy转发至紫鸟tiktok-proxy/creator服务，调用TikTok官方创作者开放接口。核心能力覆盖六大场景：达人档案查询（getcreatorprofile）、店铺商品搜索（getshopproducts）、橱窗/直播袋商品查询（getshowcaseproducts）、可购物视频内容预检（precheckshoppablevideo）、视频发布（postshoppablevideo）及发布状态追踪（getshoppablevideo_status）。完整链路遵循"选品→上传→预检→发布→查状态"MRD主流程，需前置依赖linkfox-tiktok-video-auth完成达人OAuth授权获取ttsAccessToken。 调用遵循三层架构：用户选定openId→自动换取accountTokens→经videoapi.py具名脚本或videoproxy.py通用代理透传请求。Path白名单严格限定affiliate_creator/video/creator前缀，响应以TikTok业务层JSON内code/message为最终判定依据。大文件（>10MB）需走分片上传三步流程，但Step 1初始化与Step 3绑定当前不在代理白名单，需客户端直连处理。 显著优点 官方接口权威性：直接对接TikTok创作者开放平台，非爬虫或逆向方案，接口稳定性与数据合规性有保障，支持AI生成内容标记（isaigenerated）满足平台治理要求。 全链路业务闭环：从达人档案、选品（店铺+橱窗双源）、视频预检（违规前置拦截）、发布到状态追踪，覆盖内容电商运营完整生命周期，减少多系统切换成本。 企业级工程化设计：内置checkauthdependency.py依赖检测、response_io.py大响应落盘（避免上下文溢出）、JMESPath字段投影等机制，适合高频批量调用场景。 安全隔离清晰：与TikTok Shop卖家ERP（linkfox-tiktok-shop-auth体系）严格区分，避免令牌混用风险；displayName→openId的映射机制支持多账号管理场景。 潜在缺点与局限性 二进制上传通道未打通：multipart视频文件上传（uploadshoppablevideofile）及大文件分片的init/bind步骤当前无法经developerProxy代理，用户需自行处理fileid获取或大文件直传，形成流程断点。 白名单机制刚性：Path必须匹配affiliate_creator/video/creator前缀，非白名单接口返回errcode 1005，扩展性受限；部分新开放接口需等待管理员配置。 区域配置敏感：region参数需与授权时保持一致（美国站为us而非global），跨区调用易导致令牌失效或数据异常。 轮询依赖显式实现：预检结果（PROCESSING）与发布状态查询需Agent层自行实现间隔轮询逻辑，无内置异步回调机制。 适合的目标群体 跨境MCN机构：管理多达人账号矩阵，需批量发布可购物视频、统一追踪发布状态 TikTok内容电商运营者：高频执行"选品-挂车-发布"闭环的个体创作者或运营团队 品牌方自运营团队：通过官方API对接内部ERP/内容管理系统，替代手动后台操作 开发者/自动化工程师：需将TikTok视频号能力集成至LinkFox技能生态或自研工作流 常规使用风险 令牌生命周期管理：ttsAccessToken有效期较短，Skill内无刷新逻辑，需依赖linkfox-tiktok-video-auth处理续期；令牌泄露可导致达人账号被恶意操作。 大响应内存风险：未使用response_io.py落盘机制时，达人商品库、视频列表等大数据量响应可能撑爆Agent上下文窗口。 配额与频次限制：TikTok创作者接口存在日配额（如3/day视频发布额度），Skill未内置配额预判，需用户自行处理quota返回值的业务逻辑。 预检-发布状态不一致：预检通过（SUCCESS）不代表发布一定成功，平台终审可能在发布后触发FAIL，需完整追踪状态链路。 网关转发延迟：经LinkFox→紫鸟→TikTok的三跳架构，高峰期可能存在数百毫秒级延迟，不适合实时性要求极高的交互场景。 原始说明 TikTok 视频上传 API 业务技能，经 /tiktokVideo/developerProxy 转发紫鸟 tiktok-proxy/creator 调用视频号相关开放接口（path 白名单 affiliate_creator / video / creator）。依赖 linkfox-tiktok-video-auth 取得 ttsAccessToken。当用户提到 TikTok 视频上传、上传 TikTok 视频、发布 TikTok 视频、Post Shoppable Video、发布可购物视频、Pre-check Shoppable Video、Get Shoppable Video Pre-check Result、视频内容预检、预检结果、precheck、Get Shoppable Video Status、视频发布状态、查视频是否发布成功、TikTok 达人主页、达人档案、Get Creator Profile、搜索达人店铺商品、Get Shop Products、达人橱窗商品、Get Showcase Products、showcase 商品、可带货商品、大文件分片上传、Large File Upload、分片上传视频、TikTok video upload、TikTok 视频 API、/tiktokVideo 业务接口、查询/管理 TikTok 视频号视频 时触发。即使未明确说「授权」，只要需求是通过已授权视频号执行视频上传、预检、查预检结果、发布、查发布状态、达人档案查询、店铺/橱窗商品选品或大文件上传（非 TikTok Shop 小店 ERP），也应触发。**不含授权**（授权用 linkfox-tiktok-video-auth）。