跳到导航

想把小红书视频整理成步骤或文字稿,先取什么材料?

要把小红书视频整理成步骤或文字稿,先分清要的是“笔记文字摘要”,还是“视频里实际讲了什么”。xiaohongshu.app_v2.get_video_note_detail 返回笔记描述和已登记的 H.264 视频地址;逐字稿还需要视频的字幕或转写材料,拿齐之后再整理步骤。

例如你要把一段家具安装演示整理成团队操作卡。笔记描述可能只有工具清单,视频却演示了卡扣方向和安装顺序。先用描述起草操作卡,再观看或转写视频,核对动作和讲解,把操作卡补完整。

要完成的任务决定先拿什么

任务材料与交付
快速判断这篇教程值不值得读取标题和 desc,给出基于这些文字的简短摘要
准备观看或后续处理视频取目标笔记的视频地址清单,保留原笔记来源
整理口播步骤、按时间引用补字幕或转写,保留时间点,再按视频核对
对比几篇教程的方法每篇保留实际材料与出处,按同一问题比较,缺项另列

调用 xiaohongshu.app_v2.get_video_note_detail:已有视频分享链接时填 share_text,已有确认过的笔记 ID 时填 note_id。示例:

curl -sS https://api.beatapi.io/v1/social-data/call \
-H "Authorization: Bearer $BEATAPI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"action":"xiaohongshu.app_v2.get_video_note_detail","params":{"share_text":"<video_note_share_link>"}}' \
-o xiaohongshu-video-note.json

怎样找到对应的视频?

直接调用 Social Data 返回的笔记数组在 data.data[]。先按目标 id、标题和作者找到对应的笔记对象,再从这个笔记对象的 video_info_v2.media.stream.h264[].master_url 读取地址。desc 是笔记描述,images_list 是图片信息,两者分别保留。

拿到地址后,交给能读取该视频的播放或转写工具处理,并记录工具是否实际读取成功。笔记对象里没有地址时,把视频列为待补材料;已保存的笔记描述仍可用于初筛和文字摘要。

从保存文件提取地址清单

把下面的脚本保存为 extract_video.py,运行 python3 extract_video.py xiaohongshu-video-note.json <confirmed_note_id> video-addresses.json。extract_video.py 只读本地 JSON,不收费、不下载媒体;输出的地址清单把“拿到地址”“已下载”“已转写”分开记录。没拿到地址的保留缺失状态,不伪造链接;重复的流会去重;目标不唯一或业务失败时停止;已有的输出文件不会被覆盖。

import json
import sys
from pathlib import Path
from urllib.parse import urlsplit
source, target_id, output = sys.argv[1:]
payload = json.loads(Path(source).read_text(encoding="utf-8"))
if payload.get("status") != "succeeded" or payload.get("action") != "xiaohongshu.app_v2.get_video_note_detail":
raise SystemExit("Expected a successful video-detail response")
upstream = payload.get("data", {})
if upstream.get("success") is False or ("code" in upstream and upstream["code"] != 0):
raise SystemExit("Upstream business error")
notes = upstream.get("data")
if not isinstance(notes, list):
raise SystemExit("Expected data.data note array")
matches = [note for note in notes if note.get("id") == target_id]
if len(matches) != 1:
raise SystemExit("Target must match exactly once")
note = matches[0]
streams = note.get("video_info_v2", {}).get("media", {}).get("stream", {}).get("h264", [])
urls = []
for stream in streams:
url = stream.get("master_url")
if url is None or url == "":
continue
if not isinstance(url, str):
raise SystemExit("Invalid media URL type")
parsed = urlsplit(url)
if parsed.scheme not in ("https", "http") or not parsed.hostname or parsed.username or parsed.password:
raise SystemExit("Invalid media URL")
if url not in urls:
urls.append(url)
result = {"note_id": target_id, "source_file": source, "request_id": payload.get("request_id"),
"description": note.get("desc"), "h264_urls": urls,
"media_state": "addresses_available" if urls else "no_address_in_saved_response",
"transcript_state": "not_extracted", "download_state": "not_attempted"}
with Path(output).open("x", encoding="utf-8") as handle:
json.dump(result, handle, ensure_ascii=False, indent=2)

字幕和逐字稿这一步怎样接?

当前登记的 xiaohongshu.app_v2.get_video_note_detail 输出没有确定的字幕/SRT 地址字段,不要照搬别家返回里的 ext.subtitle_url。本页流程交付视频地址和描述,自动提取字幕目前不支持。

已有字幕或转写时,保留原文和时间轴,再整理三份材料:简短要点、按顺序的步骤、需要回看核对的词句。安装教程要对照画面确认零件名、方向和顺序;自动字幕里的错字核对后单列修正。引用具体话语之前,回到对应时间点再听一遍。

把任务交给已接入工具的助手时,可以这样写:

先确认这条家具安装视频的目标笔记,取得描述和可用视频地址。只有描述时先做文字摘要并列出待补材料;已有字幕或转写时再整理实际讲解步骤,保留时间点和来源,把需对照画面的部分列出来。

给团队的交付怎样写清楚?

每篇记录原笔记链接、ID、作者、查询时间和 request_id,并标出这次实际用的是描述、视频、字幕还是转写。接手的人据此就能知道哪些结论有原话支撑,哪些步骤需要回看。

整理家具安装视频时,交付表里可以这样记:「00:18,转写,『先别拧紧』;00:23,画面,作者把横杆插进支架」。只拿到平台描述时,表里的时间点留空,写明读到的是描述。给安装步骤加引文之前,先回到字幕或转写核对原话。

视频地址保存在原响应里;需要归档时,保存实际取得的素材。长期引用以原笔记和自己的材料记录为准。当前详情查询价格见价格页,转写费用按你选择的工具另计。

分享链接与ID · AI怎样读笔记

没有平台字幕时,怎样完成文字稿?

  1. 从确认能读取的流保存你有权处理的素材,记下笔记 ID、原帖链接和文件名。拿不到文件时先向素材提供方获取,笔记描述单独保留。
  2. 在播放器或媒体工具里检查素材有没有字幕轨。另外拿到 SRT 或 VTT 文件时,先核对文件对应这个视频版本,保留原时间轴。没有字幕轨时,把已保存的音视频交给能导出带时间点文本的转写工具,按实际说话内容输出。
  3. 抽查开头、中段和结尾,再核对低置信度段落、产品名与数字。画面独有的步骤另标「画面观察」,听不清的文字保留待核。最后交付原稿和整理版,注明文字来自平台字幕或实际转写。