将视频发布至 YouTube、Instagram、Facebook 与 Threads

1. 准备一个就绪的视频素材

将本地视频上传或将公共视频 URL 导入工作区。持续检查该上传或导入，直到就绪，再在帖子中使用已登记的 asset_id 和规范 asset_url。

在平台有要求时，SosoAPI 会检查视频的实际容器、时长、尺寸和编解码器。文件名、调用方提供的 MIME 类型或可播放的预览，都不足以证明符合条件。排程前，请检查你对视频和音频的使用权，以及所有必要的披露要求。

• 将原始视频和封面素材保留在同一个已授权工作区中。
• 检查确切账号和预期格式的完整草稿资格。
• 如果准备失败，检查现有状态；不要仅因响应缓慢就重复启动导入。

2. 选择目标的视频格式

选择目标账号支持的格式和选项。可复用已就绪素材，但每个平台都需要自己的 provider_payload。

3. 排程已审核的 YouTube 视频

使用 API 参考中的服务器辅助函数。将 asset_id 替换为已登记的正整数，asset_url 替换为其规范 URL。选择频道的实际账号 ID 和未来发布时间。

此示例请求在所选时间公开发布。运行前，请向用户确认此可见性设置。将 contains_synthetic_media 设置为符合实际视频的值；false 仅为示例。UNSCHEDULE_KEEP_PRIVATE 要求 YouTube 在取消未发布的原生排程后仍将其保持为私享。

await sosoPost("/studio-api/scheduled-posts/create", {
  "workspace_id": "<workspace-uuid>",
  "social_account_id": "<youtube-channel-account-uuid>",
  "caption": null,
  "hashtags": [],
  "media": [
    {
      "kind": "video",
      "asset_id": "<ready-video-asset-id>",
      "url": "<canonical-video-asset-url>"
    }
  ],
  "provider_payload": {
    "platform": "youtube",
    "publish_options": {
      "post_type": "VIDEO",
      "title": "A reviewed product walkthrough",
      "description": "Our team introduces the product in one short walkthrough.",
      "category_id": "24",
      "privacy_status": "public",
      "cancellation_mode": "UNSCHEDULE_KEEP_PRIVATE",
      "contains_synthetic_media": false
    }
  },
  "scheduled_at": "<future-ISO-8601-instant-with-offset>",
  "display_timezone": "Asia/Hong_Kong",
  "idempotency_key": "<stable-key-for-this-one-video-intent>"
});

• 发布 API 参考

4. 明确隐私设置、Shorts 和平台限制

YouTube 使用 post_type VIDEO。你可以设置 surface_expectation: SHORT，但上传是否符合 Short 条件仍由 YouTube 决定。仅凭文件名或竖屏方向不足以证明。

上传权限与管理原生排程的权限相互独立。请检查频道是否支持缩略图等可选功能；可用性可能未知。Google 的上传参考说明了授权和元数据要求，而 SosoAPI 也会检查自身支持的字段及已连接账号。

YouTube 及其他平台处理或审核视频可能需要时间，且其配额仍然适用。上传获接受不代表视频已公开可见。

• Google：YouTube videos.insert 参考
• 账号与格式能力矩阵

5. 验证同一帖子的最终结果

存储排程帖子 ID，并检查发送进度与最终结果。可获取平台链接时，请开启检查。已排程或发布中表示最终结果仍待确认。

即使客户端中断连接，已接受排程仍会在服务器上继续。变更前，请先读取同一篇帖子。取消时使用当前版本及可用取消操作。删除已发布视频适用不同规则。

跨平台重复使用视频时，请检查各目标的要求。这些示例展示请求格式；本页不会执行或发布视频。

• 自有 agent 审核流程
• 发布 API 参考