video-summaries

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Video Summaries

视频摘要

Overview

概述

Turn a video URL into a structured AI summary. Use

socialkit-api

for auth and endpoint details. Prefer MCP tools when a client is configured.

Each summary response contains

summary

mainTopics

keyPoints

tone

targetAudience

, and

quotes

. Some platforms also return a

timeline

将视频 URL 转换为结构化的 AI 摘要。认证和 Endpoint 详情请参阅

socialkit-api

。如果客户端已配置，优先使用 MCP 工具。

每个摘要响应都包含

summary

、

mainTopics

、

keyPoints

、

tone

、

targetAudience

和

quotes

。部分平台还会返回

timeline

。

Endpoint by Platform

各平台的 Endpoint

Source	Endpoint / MCP tool
YouTube	`/youtube/summarize` / `youtube_summarize`
TikTok	`/tiktok/summarize` / `tiktok_summarize`
Instagram	`/instagram/summarize` / `instagram_summarize`
Facebook	`/facebook/summarize` / `facebook_summarize`
Direct video file URL	`/video/summarize` / `video_summarize`

Summaries are not available for X/Twitter or LinkedIn. For those, fetch the transcript with

video-transcripts

and summarize it yourself.

来源	Endpoint / MCP 工具
YouTube	`/youtube/summarize` / `youtube_summarize`
TikTok	`/tiktok/summarize` / `tiktok_summarize`
Instagram	`/instagram/summarize` / `instagram_summarize`
Facebook	`/facebook/summarize` / `facebook_summarize`
直接视频文件 URL	`/video/summarize` / `video_summarize`

X/Twitter 和 LinkedIn 不支持摘要。对于这些平台，请使用

video-transcripts

获取转录文本，然后自行总结。

Workflow

工作流程

Identify the platform and pick the matching summarize endpoint.
Call it with the full public
```
url
```
.
For more than a few same-platform URLs, use the bulk route.
Shape the output to the user's ask. If they want a one-line TL;DR, give the
```
summary
```
. If they want to decide whether to watch, lead with
```
mainTopics
```
and
```
keyPoints
```
.

识别平台并选择匹配的摘要 Endpoint。
使用完整的公开
```
url
```
调用该 Endpoint。
对于同一平台超过少量 URL，使用批量接口。
根据用户需求调整输出。如果用户需要一行式 TL;DR，返回
```
summary
```
。如果用户想判断是否值得观看，则优先提供
```
mainTopics
```
和
```
keyPoints
```
。

Single Summary

单个摘要

bash

export SOCIALKIT_API_KEY="YOUR_SOCIALKIT_ACCESS_KEY"

curl -s "https://api.socialkit.dev/youtube/summarize?url=https://youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "x-access-key: $SOCIALKIT_API_KEY"

bash

export SOCIALKIT_API_KEY="YOUR_SOCIALKIT_ACCESS_KEY"

curl -s "https://api.socialkit.dev/youtube/summarize?url=https://youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "x-access-key: $SOCIALKIT_API_KEY"

Bulk Summaries

批量摘要

Available for YouTube, TikTok, and Instagram:

bash

curl -s -X POST "https://api.socialkit.dev/tiktok/summarize/bulk" \
  -H "x-access-key: $SOCIALKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "urls": [
    "https://www.tiktok.com/@user/video/ID1",
    "https://www.tiktok.com/@user/video/ID2"
  ] }'

适用于 YouTube、TikTok 和 Instagram：

bash

curl -s -X POST "https://api.socialkit.dev/tiktok/summarize/bulk" \
  -H "x-access-key: $SOCIALKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "urls": [
    "https://www.tiktok.com/@user/video/ID1",
    "https://www.tiktok.com/@user/video/ID2"
  ] }'

Common Pitfalls

常见问题

TikTok summarySource=visual uses images and description only after confirmed caption absence. Label this source and never invent spoken quotes; operational extraction failures do not justify generating a fallback summary.
Do not summarize an X or LinkedIn video with a summarize endpoint. Transcribe first, then summarize.
When comparing several videos, run them in one bulk call rather than many single calls.

TikTok 的
```
summarySource=visual
```
仅在确认不存在 caption 后，才使用图片和描述信息。必须标明此来源，绝不能虚构口头引语；提取流程失败也不能作为生成备用摘要的理由。
不要使用摘要 Endpoint 总结 X 或 LinkedIn 视频。应先进行转录，然后再总结。
比较多个视频时，应在一次批量调用中处理，而不是发起多次单独调用。

Output Standards

输出标准

Match the depth the user asked for. Do not return all six fields when they wanted a sentence.
When summarizing many videos, add a short cross-video takeaway, not just a stack of separate summaries.

Use only public supported content. Do not route posting, private-account access, login bypass, or unrelated website scraping here. See

socialkit-api

for authentication, endpoint-specific pagination, failure handling, and credits. Preserve unknown metrics and scope conclusions to the collected sample.

输出深度应与用户要求匹配。如果用户只想要一句话，不要返回全部六个字段。
总结多个视频时，补充一段简短的多视频综合结论，而不只是堆叠单独的摘要。

仅使用受支持的公开内容。不要通过此工具处理内容发布、私密账户访问、绕过登录或抓取无关网站。有关认证、各 Endpoint 的分页、失败处理和 credits，请参阅

socialkit-api

。未知指标应原样保留，并将结论限定在已采集样本范围内。