knowhow_raw.md
6.16 KB
Publisher 技能调研 - 内容发布最佳实践
调研目标
分析内容发布的最佳实践,产出数据源清单、爬取配置、种子数据。
业务场景
ABC 公司业务场景:互动剧内容上传、生产端对接
一、数据源清单 (knowhow_raw.md)
1. 短视频平台发布规范
1.1 抖音开放平台
- 平台: 抖音
- 文档: https://open.douyin.com/
- 能力:
- 视频上传接口 (STS 直传)
- 视频发布 (标题、话题、位置)
- 草稿箱管理
- 数据分析
- 更新频率: 实时
- 爬取难度: 高 (需要企业资质)
- 权威性: 官方一手
1.2 快手创作者服务平台
- 平台: 快手
- 文档: https://developers.kuaishou.com/
- 能力:
- 视频上传 (分片上传)
- 视频发布
- 作品管理
- 更新频率: 实时
- 爬取难度: 高
- 权威性: 官方一手
1.3 视频号发布平台
- 平台: 微信视频号
- 文档: https://developers.weixin.qq.com/doc/oplatform/Video.html
- 能力:
- 视频上传
- 发布接口
- 更新频率: 实时
- 爬取难度: 高
- 权威性: 官方一手
2. 长视频平台
2.1 爱奇艺号
- 平台: 爱奇艺
- 文档: https://mp.iqiyi.com/
- 能力: 视频上传、发布、收益
2.2 优酷号
- 平台: 优酷
- 文档: https://mp.youku.com/
- 能力: 视频上传、发布
2.3 腾讯视频创作平台
- 平台: 腾讯视频
- 文档: https://v.qq.com/
- 能力: 视频上传、发布
3. 内容发布技术规范
3.1 视频上传技术要点
- 分片上传: 大视频需分片,支持断点续传
- STS 临时凭证: 主流平台使用阿里云 OSS/腾讯云 COS 的 STS 上传
- 封面图: 支持自定义封面或自动截取
- 元数据: 标题、描述、标签、分类、地点
3.2 常见限制
- 时长限制: 抖音 15分钟,快手 10分钟,视频号 1小时
- 格式: MP4/MOV,编码 H.264/H.265
- 分辨率: 720P 起步,建议 1080P
- 文件大小: 平台不同,从 100MB 到 2GB 不等
4. 互动剧特有需求
4.1 互动内容格式
- 分支剧情选择
- 时间轴标记点
- 多结局支持
4.2 平台支持情况
- 抖音: 支持小程序互动剧
- 快手: 支持磁力引擎互动内容
- B站: 支持互动视频功能
二、爬取配置 (crawl_config.json)
{
"platforms": [
{
"name": "抖音开放平台",
"api_docs": "https://open.douyin.com/",
"upload_method": "STS",
"max_duration_min": 15,
"max_size_mb": 2000,
"supported_formats": ["mp4", "mov"],
"requires_auth": true
},
{
"name": "快手创作者平台",
"api_docs": "https://developers.kuaishou.com/",
"upload_method": "分片上传",
"max_duration_min": 10,
"max_size_mb": 2000,
"supported_formats": ["mp4", "mov"],
"requires_auth": true
},
{
"name": "微信视频号",
"api_docs": "https://developers.weixin.qq.com/doc/oplatform/Video.html",
"upload_method": "COS",
"max_duration_min": 60,
"max_size_mb": 1000,
"supported_formats": ["mp4"],
"requires_auth": true
}
],
"crawl_settings": {
"rate_limit_ms": 2000,
"retry_count": 3,
"timeout_ms": 30000
}
}
三、种子数据 (seed_data.json)
由于内容发布平台 API 需要企业资质和认证,本调研产出的是平台规范和配置模板,而非实际采集数据。
测试用例设计 (10个)
[
{
"test_case": "视频分片上传",
"platform": "抖音",
"input": {
"video_path": "/path/to/video.mp4",
"part_size": 5242880
},
"expected": "返回 upload_id 和 partETag"
},
{
"test_case": "视频发布",
"platform": "抖音",
"input": {
"title": "互动剧第一集",
"description": "精彩内容",
"video_id": "obtained_from_upload"
},
"expected": "返回 video_id 和 share_url"
},
{
"test_case": "草稿箱保存",
"platform": "快手",
"input": {
"title": "测试内容",
"video_path": "/path/to/video.mp4"
},
"expected": "返回 draft_id"
},
{
"test_case": "视频号发布",
"platform": "微信",
"input": {
"title": "互动剧",
"file_name": "video.mp4",
"description": "描述"
},
"expected": "返回 media_id"
},
{
"test_case": "获取上传凭证",
"platform": "抖音",
"input": {
"file_name": "video.mp4",
"file_size": 52428800
},
"expected": "返回 upload_url 和 auth_token"
},
{
"test_case": "批量发布",
"platform": "优酷",
"input": {
"videos": [
{"title": "第一集", "path": "/path/1.mp4"},
{"title": "第二集", "path": "/path/2.mp4"}
]
},
"expected": "返回多个 video_id"
},
{
"test_case": "设置封面",
"platform": "B站",
"input": {
"video_id": "xxx",
"cover_image": "/path/to/cover.jpg"
},
"expected": "返回 cover_url"
},
{
"test_case": "添加字幕文件",
"platform": "抖音",
"input": {
"video_id": "xxx",
"subtitle_file": "/path/to/srt.srt"
},
"expected": "返回 subtitle_id"
},
{
"test_case": "互动剧标记",
"platform": "抖音",
"input": {
"video_id": "xxx",
"interaction_points": [
{"time": 120, "type": "choice", "options": ["A", "B"]}
]
},
"expected": "返回 interaction_id"
},
{
"test_case": "发布状态查询",
"platform": "快手",
"input": {"video_id": "xxx"},
"expected": "返回 status: published | processing | failed"
}
]
调研总结
关键发现
- 主流平台都采用 STS/COS 直传模式,不再支持直接 HTTP 上传
- 企业资质是准入门槛,个人无法调用发布 API
- 互动剧支持有限,抖音和 B 站有相关能力
- 分片上传是标配,支持断点续传
后续建议
- 如需实际调用,需先完成企业认证
- 可以先使用官方后台手动发布测试
- 关注各平台开发者社区的 API 更新
调研完成时间: 2026-03-27 调研人: Hunter