用途:把已生成的 agent-media 视频(来自视频技能的 R2 video_url)发布到用户已连接的社交渠道,支持 TikTok、Instagram 与 X。可通过 REST、CLI(agent-media social ...)和 MCP 工具(social_channels / social_connect / social_publish)三种方式调用,所有请求使用用户的 Authorization: Bearer ma_... 令牌访问 https://api.agent-media.ai。
连接渠道(一次性,需人工操作):GET /v1/social/providers 列出可连接网络;POST /v1/social/connect { provider } 返回 { url },用户需打开该 OAuth 链接并授权;GET /v1/social/channels 返回已连接渠道(含 id、name、provider、profile、picture);DELETE /v1/social/channels/:channelId 断开连接。CLI 对应 agent-media social providers、agent-media social connect x、agent-media social channels;MCP 对应 social_connect 与 social_channels。代理无法自行完成 OAuth。
发布视频:POST /v1/social/publish,请求体包含 video_url、channel_ids、caption 与 type("now" 立即发布,或 "schedule" 加 date 定时)。CLI 为 agent-media social publish --video <url> --channels <id,id> --caption "...",加 --at <iso> 可定时;MCP 为 social_publish。video_url 必须是 agent-media 的 R2 URL,平台会代为重新托管;channel_ids 来自 /v1/social/channels;各网络的特殊要求(如 X 回复设置)由服务端填充。返回 { success: true, media_id, post_ids },仅当 post_ids 非空才算真正发布成功,空 post_ids 应视为失败。
典型流程:用 generate_video 生成视频并取 final_output.video_url;若用户无已连接渠道,引导其完成连接;再将 video_url 发布到选定 channel_ids 并确认返回 post_ids。限制:社交操作共享速率预算,不要轮询,连接一次后按需发布。