Temu Runway 跨境视频接口文档（Temu官方视频内容接入技术指南）

Temu Runway 是拼多多旗下跨境平台 Temu 于2024年Q2正式推出的视频化商品展示与内容分发技术基础设施，面向全球卖家开放标准化API接口，支持短视频自动上传、智能标签生成、多语言字幕同步及A/B测试埋点能力。

Temu Runway 跨境视频接口文档

Temu Runway 接口文档是 Temu 官方发布的《Temu Seller Video Integration Specification v2.3.1》（2024年7月更新）的核心技术交付物，覆盖从视频元数据提交、转码调度、审核反馈到流量分发的全链路。据 Temu 卖家后台数据显示，接入 Runway 视频接口的SKU平均点击率（CTR）提升37.2%，加购转化率提升22.8%（数据来源：Temu Seller Analytics Dashboard，2024年6月全域卖家统计，样本量 N=142,856）。该接口已强制应用于美国、加拿大、澳大利亚、英国、德国、法国、西班牙、意大利、荷兰、日本等10个重点市场，且自2024年8月1日起，所有新上架的服饰、美妆、家居、3C配件类目商品须至少绑定1条符合Runway规范的视频（Temu Seller Policy Bulletin #2024-08-01）。

接口采用 RESTful 架构，基于 OAuth 2.0 认证，支持 HTTPS 协议，关键端点包括：/v2/videos/upload（预签名上传）、/v2/videos/submit（提交审核）、/v2/videos/status（状态轮询）及/v2/videos/analytics（分钟级播放热力图）。所有视频需满足：时长≤30秒、分辨率≥720p、码率≥3 Mbps、格式为MP4/H.264、首帧为静态封面（16:9比例），且必须通过 Temu AI 内容安全引擎（Temu ContentGuard v3.1）自动审核——该引擎对违禁词识别准确率达99.43%，对低质画面（模糊、抖动、黑边）拦截率达98.7%（Temu Platform Engineering White Paper, Q2 2024）。

实测数据显示，使用官方 SDK（Java/Python/Node.js三语言版本，GitHub仓库 star 数达1,247）完成全流程接入平均耗时≤4.2小时；而自行对接HTTP API的卖家平均调试周期为17.6小时，失败率高达31.5%（据 2024年6月《Temu第三方服务商技术合规报告》抽样调研，N=89家服务商）。值得注意的是，接口支持“批量视频任务提交”（单次最多50条），但要求所有视频共享同一套商品ID映射关系，且元数据JSON中product_id字段必须与Temu后台SPU ID完全一致（区分大小写，不支持ASIN或SKU别名）。

常见问题解答

{Temu Runway 跨境视频接口文档} 适合哪些卖家？是否支持非Temu自营仓模式？

适用于已完成Temu Seller Center入驻认证、拥有有效企业营业执照（中国大陆、香港、新加坡、美国注册主体均可）、且已开通Temu Fulfilled（TFN）或第三方物流（3PL）发货权限的卖家。明确支持FBM（Fulfillment by Merchant）模式，但视频审核通过后，商品页仅在“Video Verified”标签生效的国家站点（当前含美、加、英、德、法、日）展示视频入口；FBM订单履约时效不影响视频上线资格。

{Temu Runway 跨境视频接口文档} 如何开通？需要哪些资质文件？

开通无需单独申请：卖家登录 seller.temu.com → 进入【Marketing】→ 【Video Center】→ 点击【API Access】即可查看专属Client ID、Client Secret及沙箱环境Endpoint。必需资料仅两项：① 企业营业执照扫描件（加盖公章）；② 法定代表人手持证件照（系统OCR自动核验）。不接受个体工商户、个人卖家或未完成KYC的主体接入。2024年7月起，新增“视频接口调用配额管理”，新卖家首月免费额度为500次/日，超限后需购买API调用量包（1,000次/USD 29）。

{Temu Runway 跨境视频接口文档} 费用结构是怎样的？是否有隐藏成本？

接口本身无基础使用费，但存在三项刚性成本：① 视频云转码服务费：$0.012/分钟（按源文件时长计费，非播放时长）；② AI字幕生成费：$0.008/视频（支持英语/西班牙语/法语/德语/日语五语种自动翻译，人工校对需另付$0.5/条）；③ 审核失败重提费：单次失败后重新提交收取$0.003（因元数据错误导致的失败不收费）。无带宽费、存储费或流量分成。所有费用明细实时同步至Seller Center【Billing】模块，支持月结发票（PDF/Excel双格式）。

{Temu Runway 跨境视频接口文档} 常见失败原因有哪些？如何快速定位？

TOP3失败原因及排查路径：① 401 Unauthorized：检查OAuth token是否过期（有效期2小时），或Client Secret是否被意外重置（Seller Center【Security Settings】中可查操作日志）；② 422 Unprocessable Entity：92.6%源于product_id与Temu后台SPU不匹配（建议用Seller Center【Inventory】→【Manage Products】导出SPU清单比对）；③ 503 Service Unavailable：仅出现在每日02:00–03:00 UTC系统维护窗口，属正常现象，无需重试。所有错误均返回标准RFC 7807格式Problem Detail JSON，含instance_id可用于工单溯源。

{Temu Runway 跨境视频接口文档} 与Shopify Video App或第三方MCN代运营相比，核心差异在哪？

Runway是唯一能触发Temu首页“Video Carousel”自然流量池的接口，而Shopify插件仅作用于独立站；第三方MCN代运营无法获取/v2/videos/analytics原始播放热力图数据（Temu政策禁止向外部传输用户行为粒度数据）。优势在于：① 流量加权权重高（视频商品在搜索结果页获得+15%排序系数）；② 审核通过即同步至全站点（无需逐国提交）。劣势在于：不支持UGC内容聚合、无达人合作分佣功能、暂未开放直播切片自动转短视频能力。

新手最容易忽略的技术细节是什么？

97.3%的新手在首次调用/v2/videos/submit时遗漏language_preference字段——该字段非必填，但若为空，系统将默认使用商品主图语言（如英文主图则生成英文字幕），导致西班牙站商品误配英文字幕，触发审核驳回。正确做法：显式传入"language_preference": ["es-ES"]（多语种用数组，顺序决定优先级）。该字段已在v2.3.1文档第4.2.5节加粗标注，但未在SDK默认模板中预置。

Temu Runway 视频接口是当前提升跨境商品转化效率最直接、最可控的技术杠杆。