排期发布到社交媒体
设置:填写以下内容
在首次运行前,替换下方所有占位符。
| 占位符 | 说明 |
|---|---|
<YOUR_METRICOOL_BLOG_ID> | 您的Metricool品牌的blogId(从getBrandSettings获取) |
<YOUR_TIMEZONE> | 排期使用的IANA时区,例如America/Chicago |
<YOUR_POST_TIME> | 每日默认发布时间,例如10:00 |
<YOUR_IG_HANDLE>, <YOUR_TIKTOK_HANDLE>, <YOUR_YOUTUBE_CHANNEL_ID> | 在Metricool中连接的账号 |
<YOUR_DRIVE_UPLOAD_FOLDER_ID> | 一个Google Drive文件夹,设置为“拥有链接的任何人均可查看”(参见媒体跳转部分) |
<YOUR_VIDEO_LIBRARY> | 已完成文件的存放位置,例如~/Videos/Finished |
<YOUR_STANDING_CTA> | 可选的结尾语,用于每条文案末尾 |
<YOUR_VOICE_FILE> | 可选:语音/风格指南文件的路径,用于文案撰写 |
品牌: blogId <YOUR_METRICOOL_BLOG_ID>,时区 <YOUR_TIMEZONE>。
已连接的账号: Instagram(<YOUR_IG_HANDLE>),TikTok(<YOUR_TIKTOK_HANDLE>),YouTube(<YOUR_YOUTUBE_CHANNEL_ID>)。
媒体跳转(这部分不太直观)
Metricool的API仅接受公共URL。它不能接受本地文件。工作链路如下:
- 将MP4文件上传到Drive文件夹,例如**
Metricool Uploads (Claude)**(<YOUR_DRIVE_UPLOAD_FOLDER_ID>)。将该文件夹设置为“拥有链接的任何人均可查看”一次;文件会继承该权限,因此无需为每个文件单独设置共享。cd <文件所在目录> && gws drive files create \ --params '{"uploadType":"multipart","supportsAllDrives":true}' \ --json '{"name":"<名称>.mp4","mimeType":"video/mp4","parents":["<YOUR_DRIVE_UPLOAD_FOLDER_ID>"]}' \ --upload "<文件>" - 使用直接下载URL进行排期:
https://drive.google.com/uc?id=<fileId>&export=download。/view链接会导致“无法规范化媒体”错误。 - Metricool将文件复制到自己的存储空间;响应中的
media字段会变为static.metricool.com/...。 - 看到该变化后,删除Drive中的副本。这样可以避免存储空间不断累积。
Claude通常无法将Drive文件设为公开(沙箱会阻止该操作),也无法编辑其自身权限。这就是共享文件夹存在的原因。如果文件最终位于文件夹之外,请要求用户将其移入,而不是尝试进行共享。
文案
如果您有语音指南,请先阅读<YOUR_VOICE_FILE>并遵循其风格。否则,使用以下默认规则。
当短视频包含评论关键词CTA(一个触发自动私信或邮件的关键词)时,第一行是CTA:
- 第一行:
评论 <KEYWORD>,我将免费为您发送 <资源名称> 👇,关键词全部大写,与短视频CTA片段中说的完全一致。 - 然后是钩子行和下方的2-4行教学内容。
- 结尾使用固定CTA(如果您使用的话)。
- 关键词必须与短视频中说的CTA一致(视频状态文件中的
reel_cta)。每个视频一个关键词。
无关键词CTA的短视频格式:
- 第一行是钩子。 这是信息流中显示的唯一一行。通常与短视频开场的第一句话相同。
- 2-4行简短文字,教授一个知识点。行与行之间用换行符分隔,不要写成段落。
- 不要滥用标签。尽量少用或不用。
- 使用固定CTA
<YOUR_STANDING_CTA>结尾(如果有的话)。
根据短视频的实际内容编写,使用创作者的原文措辞,而不是泛泛的建议。简短但有教育意义:观众仅从文案就能学到一条有用的信息。
通用示例:
“每天发帖 = 倦怠 / 每周发3个优质视频 = 增长”
“一个小技巧:如果您想要更好的音质,请将麦克风放近一点,而不是提高增益...”
渲染
文案是叠加在视频上的:video-reels将其作为V3轨道的alpha叠加素材放置,文本钩子卡片位于V2轨道。无需导入,无需勾选叠加复选框。
- 用户对短视频进行修剪。两条叠加轨道是独立的素材,因此修剪V1轨道不会移动它们。如果重新剪辑了时间线,请重新渲染该短视频的文案,而不是滑动它们。
- Claude通过Resolve API渲染它们。 四个短视频大约需要90秒。
out = os.path.expanduser("~/Movies/<video>-deliverables/reels-final")
os.makedirs(out, exist_ok=True)
project.DeleteAllRenderJobs()
for i in range(project.GetTimelineCount()):
t = project.GetTimelineByIndex(i+1)
if not t.GetName().startswith("Reel"):
continue
project.SetCurrentTimeline(t)
project.SetRenderSettings({"TargetDir": out, "CustomName": t.GetName().replace(" ", "_"),
"SelectAllFrames": True, "FormatWidth": 1080, "FormatHeight": 1920,
"ExportVideo": True, "ExportAudio": True})
project.SetCurrentRenderFormatAndCodec("mp4", "H264")
project.AddRenderJob()
然后调用start_rendering。编解码器字符串是"H264",而不是"H.264",格式是"mp4"。轮询输出目录而不是作业状态;文件在完成后会直接出现。30秒的短视频预计约40MB。
3. 渲染是时间线的不可逆点,因此请先完成所有修剪工作。
4. 在上传前使用ffmpeg抽检输出,在钩子窗口内抽一帧,在短视频中间抽一帧:
ffmpeg -v error -ss 1.5 -i reel.mp4 -frames:v 1 hook.png -y
ffmpeg -v error -ss 8 -i reel.mp4 -frames:v 1 cap.png -y
将它们堆叠成一张校对表并实际查看。这是捕获缺失钩子卡片或空白文案轨道的最后一环,排期后无法删除。
已完成文件的存储位置
保留的所有内容都存放在<YOUR_VIDEO_LIBRARY>/目录下,每个视频一个文件夹:
<YOUR_VIDEO_LIBRARY>/<视频名称> YYYY-MM-DD/
Reels/ 发布的内容。1080x1920 H.264
Reels/Masters/ 相同剪辑,60 Mbps存档
Timelines/ 每个时间线的.drt文件 + 项目.drp文件
Covers/ 已批准的Instagram短视频封面,1080x1920 JPG
Thumbnails/ 完整尺寸的缩略图选项
YouTube/ 导出的长视频版,交付版+主存档
Posting schedule.txt 发布内容、发布位置和发布时间的记录
上传文件:达到Instagram发布API允许的最高质量
Metricool通过Meta的内容发布API发帖,该API对其接受的内容有上限。上传符合这些上限的最佳文件,文件由60 Mbps主存档生成,而非Resolve的交付渲染:
- H.264 High, yuv420p, 1080x1920, 封闭GOP, moov at the front(
+faststart) - 视频最高24 Mbps(上限是25),音频AAC 128 kbps 48 kHz(Resolve会输出320 kbps,超出限制)
- 仅包含视频和音频流。 Resolve会添加一个时间码数据轨道;使用
-dn将其删除
ffmpeg -i "Masters/<n>.mp4" -map 0:v:0 -map 0:a:0 -map_metadata -1 -dn \
-c:v libx264 -preset slow -crf 11 -maxrate 24M -bufsize 48M -pix_fmt yuv420p -profile:v high \
-g 48 -keyint_min 48 -sc_threshold 0 -flags +cgop \
-c:a aac -b:a 128k -ar 48000 -movflags +faststart "Reels/<n>.mp4"
在CRF 16下,仅人物对话素材仅使用了约8 Mbps,因此CRF 11会消耗更多预算。在后台运行此命令,因为使用-preset slow时,多个短视频可能需要几分钟。一次只编码一个文件,不要并行编码: 多个并行编码可能会在写入过程中填满磁盘,导致每个文件截断。Instagram仍然会在其端重新压缩;这确保了它从尽可能干净的源文件开始。
每个短视频进行两次渲染,而不是一次。 相同编解码器,相同分辨率,不同比特率:
| 分辨率 | 比特率 | 用途 | |
|---|---|---|---|
| 交付版 | 1080x1920 H.264 | Resolve处理,然后由上述上传文件替换 | 上传 |
| 主存档 | 1080x1920 H.264 | 通过"VideoQuality": 60000设置60 Mbps | 存档 |
长视频版本(1920x1080)同样进行两次处理:10分钟视频约900MB交付版,约4.5GB主存档。
1080x1920是正确的分辨率:无论哪种方式,Instagram都以1080宽度提供,并且短视频裁剪已经是从4K过采样得到的。除非被要求,否则不要提供ProRes或更大的画幅。
VideoQuality 是粘性的。每次传递都必须设置。
渲染设置存在于项目中,而不是作业中。如果在SetRenderSettings调用中遗漏VideoQuality,渲染会静默复用上一次的设置。继承自短视频主存档的60000的长视频交付版,其输出体积会比预期大5倍。
project.SetRenderSettings({..., "VideoQuality": 12000}) # 交付版,~12 Mbps
project.SetRenderSettings({..., "VideoQuality": 60000}) # 主存档,~60 Mbps
永远不要依赖交付版的默认值。并且永远不要相信作业列表: 即使VideoQuality已应用,从GetRenderJobList()读取时仍可能返回None。检查已完成文件:
ffprobe -v error -select_streams v:0 -show_entries stream=bit_rate -of csv=p=0 out.mp4
在排队长视频对之前检查可用空间。 60 Mbps下10分钟的主存档约4.5GB。
同时将时间线导出到文件夹中,这样无需项目数据库即可移植编辑:
for i in range(project.GetTimelineCount()):
t = project.GetTimelineByIndex(i+1)
t.Export(os.path.join(d, t.GetName() + ".drt"), resolve.EXPORT_DRT)
resolve.GetProjectManager().ExportProject(project.GetName(), os.path.join(d, project.GetName() + ".drp"))
- 直接渲染到目标文件夹。 将Resolve的
TargetDir设置为<该文件夹>/Reels,这样之后无需移动任何内容。 - 根据Resolve时间线名称重命名。
Reel_2_-_my_best_tip.mp4变为2. my best tip.mp4:按数字排序以便于排序,一目了然。主存档和.drt文件的名称相同,这样三个文件夹可以对应起来。 - 移动,而不是复制。
~/Movies/<video>-*目录保存工作文件(whisper JSON、SRT、叠加mov、文案mov)。这些文件保留用于重新渲染;已完成导出的文件将移走。 - 排期完成后编写
Posting schedule.txt,列出每个短视频的日期、时间和网络,这样用户无需打开Metricool即可知道哪些内容已发布。
仅当渲染因空间不足而实际失败,或者长视频对明显无法放入时,才提及磁盘空间。
封面(仅限Instagram)
每个短视频在排期前都会获得一个自定义的Instagram封面。在文案获得批准后、排期之前,运行reel-covers技能。它会为每个短视频返回一个经批准的JPG文件,存放在<Video>/Covers/目录下。在文案和时间审核的同时展示封面,以便一次性批准所有内容。
通过与视频相同的Drive跳转方式(同一文件夹<YOUR_DRIVE_UPLOAD_FOLDER_ID>,mimeType: image/jpeg)上传每个封面,并使用uc?id=...&export=download形式作为videoThumbnailUrl传递。一旦Metricool拥有自己的副本后,删除Drive中的副本,方法与视频相同。
排期
每个短视频一条帖子,包含所有三个网络,并包含封面。 封面仅对Instagram有意义。TikTok的个人账号会忽略它,YouTube Shorts仅在经过验证的频道上显示它。不要拆分帖子。
"providers":[{"network":"instagram"},{"network":"tiktok"},{"network":"youtube"}],
"media":["https://drive.google.com/uc?id=<video id>&export=download"],
"videoThumbnailUrl":"https://drive.google.com/uc?id=<cover id>&export=download",
"instagramData":{"type":"REEL","showReelOnFeed":true,"isAiGenerated":false},
"tiktokData":{"privacyOption":"PUBLIC_TO_EVERYONE","title":"<short title>"},
"youtubeData":{"type":"short","privacy":"public","madeForKids":false,"title":"<title, <100 chars>"}
- 向已排期的帖子添加封面: 使用
updateScheduledPost,传入帖子的完整原始字段(文本、提供者、媒体、所有网络数据、日期)以及videoThumbnailUrl。它会覆盖原有内容且不可撤销,因此请从getScheduledPosts逐字复制字段。切勿替换现有的videoThumbnailUrl或videoCoverMilliseconds:已有这些字段的帖子已经选定了封面。 - 如果某个更新因“无法规范化媒体”失败而其他更新成功,则本次从Drive的获取失败了。该帖子保持不变。重新上传文件(获取新的id)并重试。重试相同的URL不会有效。
- 然后使用
getScheduledPosts检查每个帖子的videoThumbnailUrl现在是否以static.metricool.com开头,并删除Drive中的副本。 - YouTube需要标题和
madeForKids字段。 TikTok需要简短标题。 autoPublish: true让Metricool自动发布。
何时排期(默认规则,可按喜好调整)
从明天开始。每天一条帖子。如果某天已有内容,则移到下一个空闲日。
day = 明天
for each post in order:
while day already has a scheduled post: day += 1
schedule at <YOUR_POST_TIME> local on day
day += 1
<YOUR_POST_TIME>in<YOUR_TIMEZONE>是默认发布时间。- 始终先调用
getScheduledPosts,覆盖从明天到明天+(帖子数量+14天)的范围,以便查看空白时段。跳过此检查可能会导致帖子落在已被占用的时间段。 - 如果某天任何内容被排期(包括草稿),则视为被占用。
- 不要将多个帖子挤在同一天,也不要留空:目标是立即开始、稳定连续的每日发布。
- 切勿在文案文本中添加测试标签。 不要使用“测试草稿”,不要使用“可删除”。文案始终是最终版本,即使在测试运行中也是如此;用户可能希望保留它。
使用**
draft: true+autoPublish: false** 标记测试帖子(草稿在规划器中视觉上不同),并提供plannerUrl和帖子id以便一键删除。
长视频YouTube(主视频,非Shorts)
建议:不要通过Metricool发送大型长视频文件。请直接在YouTube Studio中上传。 通过Metricool发送约1GB的导出文件可能会在传输过程中被截断存储。Resolve将MP4索引(moov)放在文件末尾,因此截断的副本不可读,YouTube会在“发布”后报告“处理中止”。Metricool可能不会报告错误。将文件、标题、描述和缩略图交给用户,让他们粘贴到Studio中,以4K渲染(Studio没有文件大小问题)。以下内容仅供参考。
如果对大型文件使用Metricool,请检查存储的...