通过TikTok API上传视频时标题不显示的问题排查
TikTok API上传视频自定义标题不显示的排查方向
- 确认权限范围:检查你的access token是否包含
video.publish的完整权限。如果权限不全,TikTok可能会忽略自定义标题字段,仅保留应用默认的Hashtag。 - 检查标题合规性:TikTok对标题有内容限制,比如违规关键词、特殊字符或长度超限(通常上限150字符)。可以先测试纯文本标题(不带Hashtag),排查是否是内容触发了过滤机制。
- 核对字段名称与API版本:确认你使用的v2 API是否确实用
title字段作为标题参数。虽然官方文档标注是title,但部分场景下可能存在字段名变更,建议核对最新的TikTok开放平台文档确认。 - 检查应用后台默认配置:登录TikTok开发者后台,查看你的应用是否设置了全局默认发布标题/Hashtag。如果有该配置,可能会覆盖API请求中传入的自定义标题。
- 排除视频元数据干扰:因为你使用
PULL_FROM_URL方式上传,视频文件自身的元数据(比如原视频自带的标题)可能会被TikTok优先读取,导致API传入的标题被忽略。可以尝试重新导出不带元数据的视频文件进行测试。
你的代码示例:
return await fetch('https://open.tiktokapis.com/v2/post/publish/inbox/video/init/', { method: 'POST', headers: { 'Authorization': `Bearer ${accessToken}`, 'Content-Type': 'application/json; charset=UTF-8' }, body: JSON.stringify({ post_info: { privacy_level: 'PUBLIC_TO_EVERYONE', title: "Hello #world", }, source_info: { source: 'PULL_FROM_URL', video_url: `THE VIDEO URL` } }) })
内容的提问来源于stack exchange,提问作者Christian Kellner
相关产品推荐
相关产品推荐

