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 视频号发布平台

2. 长视频平台

2.1 爱奇艺号

2.2 优酷号

2.3 腾讯视频创作平台

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"
  }
]

调研总结

关键发现

  1. 主流平台都采用 STS/COS 直传模式,不再支持直接 HTTP 上传
  2. 企业资质是准入门槛,个人无法调用发布 API
  3. 互动剧支持有限,抖音和 B 站有相关能力
  4. 分片上传是标配,支持断点续传

后续建议

  • 如需实际调用,需先完成企业认证
  • 可以先使用官方后台手动发布测试
  • 关注各平台开发者社区的 API 更新

调研完成时间: 2026-03-27 调研人: Hunter