> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

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

> 从复盘视频教程的任务出发，分别取得笔记描述和视频地址，按实际材料制作摘要，保留字幕或转写缺口。

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

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

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

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

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

```bash
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，不收费、不下载媒体；输出的地址清单把“拿到地址”“已下载”“已转写”分开记录。没拿到地址的保留缺失状态，不伪造链接；重复的流会去重；目标不唯一或业务失败时停止；已有的输出文件不会被覆盖。

```python
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，画面，作者把横杆插进支架」。只拿到平台描述时，表里的时间点留空，写明读到的是描述。给安装步骤加引文之前，先回到字幕或转写核对原话。

视频地址保存在原响应里；需要归档时，保存实际取得的素材。长期引用以原笔记和自己的材料记录为准。当前详情查询价格见[价格页](https://beatapi.io/zh/pricing)，转写费用按你选择的工具另计。

[分享链接与ID](/zh/faq/xiaohongshu-share-links) · [AI怎样读笔记](/zh/faq/xiaohongshu-ai-reading)

## 没有平台字幕时，怎样完成文字稿？

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