视频解析 API |反推视频提示词案例

简介: 本视频为16秒温馨短发改造纪录:米色针织帽+橙色镜片眼镜的纹身美甲理发师,为白衫短发顾客梳理蓬松卷翘新造型;穿插V字手势、绿鹦鹉互动、镜前特写等6段运镜,暖光木质场景,电子BGM无对白,呈现轻松治愈的变美全过程。(238字)

视频反推提示词 ·

反推原文

核心主题

视频核心是展示女性理发后的全新造型,以及造型完成后与他人(包含鹦鹉)的互动,呈现变造型的全过程与之后的轻松氛围

人物设定

  • 站着的理发师:戴着米色针织帽、橙色镜片眼镜,穿着带有绿色卡通图案的紫色彩色卫衣,佩戴手表、戒指、手链等饰品,手部有纹身,美甲色彩丰富
  • 坐着的顾客:身穿白色宽松上衣,佩戴黑色绳状吊坠项链,短发自然柔和,性格活泼爱笑

场景&光影

场景为室内空间,整体风格偏简约温馨,包含客厅、镜前区域等;光影方面,有自然的室内光线与局部光束(如靠近窗帘处的光线),营造出温暖的氛围

分镜动作&运镜规则&背景风格(按时间顺序拆解)

  1. 0.0-4.3秒:固定镜头,背景为室内房间,有椅子、木质隔断等陈设,理发师站在坐着的顾客身后,用梳子梳理顾客头发,整理头发后完成初步造型
  2. 4.3-7.3秒:跟随镜头,背景切换到带有镂空木质屏风的区域,造型完成后顾客开心抬手比出“V”字手势,理发师在其身后,氛围轻松愉悦
  3. 7.3-8.4秒:推近特写镜头,聚焦顾客的短发,头发蓬松卷翘,呈现完成后的细节效果
  4. 8.4-10.5秒:固定镜头,背景为有开关面板的墙面、百合花,顾客与理发师并肩站立,顾客手里有一只绿色鹦鹉,画面温馨
  5. 10.5-13.5秒:环绕镜头,顾客将鹦鹉放在手上,随后低头看向鹦鹉,理发师抬手轻触顾客的短发,关注造型细节
  6. 13.5-15.5秒:拉远镜头,背景为带有几何纹样的木质屏风,顾客手拿手机,和理发师并肩站立,开心看向镜头,画面融洽自然

人物动作详细描述

  • 0.0-4.3秒:理发师用一只手梳理顾客的头发,另一只手配合固定头发,动作细致,专注于造型整理;顾客闭眼放松,随后睁眼看向镜头
  • 4.3-7.3秒:顾客头发造型完成后,抬手比出“V”字手势,随后用手捂着嘴笑,情绪开心;理发师在顾客身后,身体微侧,配合顾客的状态
  • 8.4-10.5秒:顾客转头看向镜头,随后侧身展示短发;理发师站在顾客身侧,手指向上比划动作
  • 10.5-13.5秒:顾客伸出手让鹦鹉停留,低头关注鹦鹉状态;理发师抬手轻拂顾客头顶的短发,查看造型效果
  • 13.5-15.5秒:顾客交叉手臂,手里拿着手机,开心看向镜头;理发师站在顾客身后,手臂交叉,和顾客一同看向镜头,氛围轻松

语音内容

视频全程无清晰可识别的人类说话内容,背景音乐为电子合成的节奏感旋律,覆盖整段视频,烘托出活泼动感的氛围

结构化拆解(依据接口原文归纳,归纳动作为模型补充)

维度 描述
画面主体 两位女性:戴米色针织帽与橙色镜片眼镜、穿绿色卡通图案紫色卫衣、有纹身与彩色美甲的理发师;穿白色宽松上衣、戴黑色绳状吊坠项链、活泼爱笑的短发顾客。一只绿色鹦鹉作为后半段互动道具。
光线色调 室内自然光为主,窗帘处有局部光束;暖色调、低对比、柔和通透,整体简约温馨。
镜头运动 固定 → 跟随 → 推近特写 → 固定 → 环绕 → 拉远,六段递进,从过程记录过渡到成果展示。
构图 人物居中或并肩站立,理发师多在顾客身后;木质隔断/镂空屏风提供层次与遮挡,镜前区域强化"造型完成"叙事,特写聚焦短发蓬松卷翘的质感。
节奏 16 秒 6 个镜头,平均约 2.6 秒/镜;前段梳理动作细致缓慢,后段比 V、鹦鹉互动、对镜头笑的节奏明显加快;电子合成节奏 BGM 贯穿,无清晰人声。
可复用提示词 见下方「模型补充创作建议」中的完整提示词(依据接口原文改写为生成指令)。

本表为对接口返回原文的维度归纳,未新增事实性描述。

可复用提示词

### 核心主题
视频核心是展示女性理发后的全新造型,以及造型完成后与他人(包含鹦鹉)的互动,呈现变造型的全过程与之后的轻松氛围

### 人物设定
- 站着的理发师:戴着米色针织帽、橙色镜片眼镜,穿着带有绿色卡通图案的紫色彩色卫衣,佩戴手表、戒指、手链等饰品,手部有纹身,美甲色彩丰富
- 坐着的顾客:身穿白色宽松上衣,佩戴黑色绳状吊坠项链,短发自然柔和,性格活泼爱笑

### 场景&光影
场景为室内空间,整体风格偏简约温馨,包含客厅、镜前区域等;光影方面,有自然的室内光线与局部光束(如靠近窗帘处的光线),营造出温暖的氛围

### 分镜动作&运镜规则&背景风格(按时间顺序拆解)
1. 0.0-4.3秒:固定镜头,背景为室内房间,有椅子、木质隔断等陈设,理发师站在坐着的顾客身后,用梳子梳理顾客头发,整理头发后完成初步造型
2. 4.3-7.3秒:跟随镜头,背景切换到带有镂空木质屏风的区域,造型完成后顾客开心抬手比出“V”字手势,理发师在其身后,氛围轻松愉悦
3. 7.3-8.4秒:推近特写镜头,聚焦顾客的短发,头发蓬松卷翘,呈现完成后的细节效果
4. 8.4-10.5秒:固定镜头,背景为有开关面板的墙面、百合花,顾客与理发师并肩站立,顾客手里有一只绿色鹦鹉,画面温馨
5. 10.5-13.5秒:环绕镜头,顾客将鹦鹉放在手上,随后低头看向鹦鹉,理发师抬手轻触顾客的短发,关注造型细节
6. 13.5-15.5秒:拉远镜头,背景为带有几何纹样的木质屏风,顾客手拿手机,和理发师并肩站立,开心看向镜头,画面融洽自然

### 人物动作详细描述
- 0.0-4.3秒:理发师用一只手梳理顾客的头发,另一只手配合固定头发,动作细致,专注于造型整理;顾客闭眼放松,随后睁眼看向镜头
- 4.3-7.3秒:顾客头发造型完成后,抬手比出“V”字手势,随后用手捂着嘴笑,情绪开心;理发师在顾客身后,身体微侧,配合顾客的状态
- 8.4-10.5秒:顾客转头看向镜头,随后侧身展示短发;理发师站在顾客身侧,手指向上比划动作
- 10.5-13.5秒:顾客伸出手让鹦鹉停留,低头关注鹦鹉状态;理发师抬手轻拂顾客头顶的短发,查看造型效果
- 13.5-15.5秒:顾客交叉手臂,手里拿着手机,开心看向镜头;理发师站在顾客身后,手臂交叉,和顾客一同看向镜头,氛围轻松

### 语音内容
视频全程无清晰可识别的人类说话内容,背景音乐为电子合成的节奏感旋律,覆盖整段视频,烘托出活泼动感的氛围

模型补充创作建议(非接口返回,供生成工具直接使用)

完整提示词(16 秒版,可直接复制):

室内温馨简约的短发改造纪录短片,16 秒,无人物对白,电子合成节奏 BGM 贯穿。
人物:理发师为年轻女性,戴米色针织帽与橙色镜片眼镜,穿带绿色卡通图案的紫色卫衣,
手部有纹身、彩色美甲,佩戴手表戒指手链;顾客为年轻女性,穿白色宽松上衣,
戴黑色绳状吊坠项链,短发自然蓬松卷翘,性格活泼爱笑。
场景:简约温馨的室内空间,客厅与镜前区域,木质隔断、镂空木质屏风、几何纹样屏风、
墙面开关与百合花点缀。
光线:自然室内光,窗帘处有局部光束,暖色调、柔和通透、低对比。
分镜:
1) 0-4.3s 固定镜头,理发师站在坐着的顾客身后,双手用梳子细致梳理顾客头发,顾客闭眼放松后睁眼看向镜头;
2) 4.3-7.3s 跟随镜头移至镂空屏风区域,造型完成,顾客开心抬手比 V 并捂嘴笑,理发师在身后微侧身配合;
3) 7.3-8.4s 推近特写,聚焦顾客蓬松卷翘的短发细节;
4) 8.4-10.5s 固定镜头,顾客与理发师并肩站立,顾客手握绿色鹦鹉,背景有墙面开关与百合花;
5) 10.5-13.5s 环绕镜头,顾客伸手让鹦鹉停留并低头注视,理发师轻拂顾客头顶短发查看造型;
6) 13.5-15.5s 拉远镜头,几何纹样屏风前,顾客拿手机与理发师并肩、手臂交叉,一同开心看向镜头。
风格:生活化 vlog 质感,自然表演,暖色调,氛围轻松愉悦,画面干净。

风格变体 1 · 日系清新居家感:

日系清新居家风短发改造短片,米白与浅木色为主色调,柔和窗光与轻微过曝的高调画面。
年轻女性理发师穿米色针织开衫,在自然光客厅为穿白衬衫的顾客梳理蓬松短发;
固定中景开场,跟随镜头转向木质屏风,顾客比 V 笑,短发特写,拉远收尾两人并肩看向镜头。
节奏轻快,电子节拍 BGM,无对白,胶片感轻微颗粒,温暖治愈。

风格变体 2 · 更有戏剧感的沙龙成片:

时尚沙龙感短发改造短片,深色木质背景与局部聚光,冷暖对比、质感高级。
戴橙色镜片眼镜的理发师为顾客完成短发造型,手部纹身与彩色美甲在特写中清晰可见;
固定镜头梳理 → 推近发丝特写 → 环绕展示 → 拉远定格,顾客开心比 V,绿鹦鹉停在手上作为记忆点,
最后两人对镜头笑。节奏由慢到快,电子合成 BGM,无对白,电影感浅景深。

风格变体 3 · 鹦鹉互动趣味向:

轻松趣味的室内短发改造短片,主角是一只绿色鹦鹉与刚剪完短发的年轻女性。
客厅与镜前区域,暖色自然光,百合花与几何纹样屏风点缀;
顾客先闭眼放松接受梳理,完成后比 V 大笑,随后鹦鹉落到手上,顾客低头与鹦鹉互动,
理发师轻拂顾客短发检查造型,最后两人拿手机并肩对镜头笑。
固定 → 跟随 → 特写 → 环绕 → 拉远,节奏明快,电子节奏 BGM 无对白,生活化治愈氛围。

先说结论:这是一个同步接口,不是异步任务

很多同学接解析类接口时,第一反应是去找 task_id 和回调。这个接口不用。

项目 官方口径
接口地址 https://xiaoapis.com/api/video/videoparse
请求方式 GET / POST / JSON 均可
返回格式 application/json
响应模型 同步,一般 2~5 秒返回
鉴权 请求参数 key(控制台 → 密钥管理)
计费 每次成功解析扣 1 点,约 0.01 元/次
不扣费场景 参数错误、解析失败、500 服务内部错误
频率 20 QPS(免费/测试用户 10 QPS 总限),每日次数不限
免费额度 10 次

支持平台(官方文档列表):抖音、快手、小红书、哔哩哔哩、微博、皮皮虾、西瓜视频、好看视频、TikTok、YouTube、Instagram、Twitter/X、Facebook、豆包、千问、可灵。

注意:微信视频号是独立接口 /api/video/weixin,不在这个接口的支持列表里。


请求参数:只有 3 个,但 flat 决定你要写多少兼容代码

参数 类型 必填 说明
key string 是 接口密钥,控制台 → 密钥管理查看
url string 是 待解析链接,完整 URL 或分享短链,最大 2048 字符;兼容 content、link;可直接粘贴带网址的分享口令,接口会自动提取链接
flat int 否 出参结构:2 = 单层 data,type 只输出 视频 / 图集 / 实况图集(默认,推荐);1 = 单层 data,保留平台原始 type;0 = 兼容旧版双层 data

请求 HEADER:Content-Type: application/x-www-form-urlencoded;charset:utf-8; 或 application/json。

建议新项目一律显式传 flat=2。理由很实际:不同平台对内容类型的命名不一样,用 flat=2 可以把 data.type 收敛成 3 个枚举值,下游分支不用写十几行 if/else。


最小可运行示例(Python 标准库,零依赖)

密钥只从服务端环境变量读取,不要写进代码、前端、App 包或公开仓库。

# parse_once.py  ——  pip 不需要装任何东西,python3 parse_once.py 即可
import json
import os
import urllib.parse
import urllib.request

ENDPOINT = "https://xiaoapis.com/api/video/videoparse"

def parse_video(share_text: str) -> dict:
    api_key = os.environ["XIAOAPIS_KEY"]          # 服务端环境变量
    query = urllib.parse.urlencode({
   
        "key": api_key,
        "url": share_text,
        "flat": 2,
    })
    req = urllib.request.Request(
        f"{ENDPOINT}?{query}",
        headers={
   "Accept": "application/json"},
        method="GET",
    )
    with urllib.request.urlopen(req, timeout=15) as resp:
        return json.loads(resp.read().decode("utf-8"))

if __name__ == "__main__":
    # 可直接粘贴整段分享口令,接口会自动提取其中的 http(s) 地址
    result = parse_video("https://v.douyin.com/xxxxx/")
    print(json.dumps(result, ensure_ascii=False, indent=2))

运行前:

export XIAOAPIS_KEY='控制台申请的密钥'
python3 parse_once.py

# parse_client.py
import json
import os
import time
import urllib.error
import urllib.parse
import urllib.request

ENDPOINT = "https://xiaoapis.com/api/video/videoparse"
RETRYABLE_HTTP = {
   500, 502, 503, 504}

def _request(params: dict, timeout: int = 15) -> dict:
    query = urllib.parse.urlencode(params)
    req = urllib.request.Request(
        f"{ENDPOINT}?{query}",
        headers={
   "Accept": "application/json"},
        method="GET",
    )
    with urllib.request.urlopen(req, timeout=timeout) as resp:
        return json.loads(resp.read().decode("utf-8"))

def parse_with_retry(share_text: str, max_retry: int = 2) -> dict:
    """仅对 500/网络异常重试:官方文档说明 500 不扣费,解析失败不扣费。
    400/403 属于参数或鉴权问题,重试没有意义,应直接让上层告警。"""
    params = {
   "key": os.environ["XIAOAPIS_KEY"], "url": share_text, "flat": 2}
    for attempt in range(max_retry + 1):
        try:
            body = _request(params)
            code = body.get("code")
            if code == 200:
                return body
            if code == 403:
                raise PermissionError("密钥无效或没有权限,检查控制台密钥管理")
            if code == 400:
                raise ValueError(f"参数错误/链接无法解析/点数不足:{body.get('msg')}")
            if code == 500 and attempt < max_retry:
                time.sleep(1.5 * (attempt + 1))
                continue
            raise RuntimeError(f"解析失败 code={code} msg={body.get('msg')}")
        except urllib.error.HTTPError as exc:
            if exc.code in RETRYABLE_HTTP and attempt < max_retry:
                time.sleep(1.5 * (attempt + 1))
                continue
            raise
        except urllib.error.URLError as exc:
            if attempt < max_retry:
                time.sleep(1.5 * (attempt + 1))
                continue
            raise RuntimeError(f"网络异常:{exc.reason}") from exc
    raise RuntimeError("重试次数耗尽")

def to_material_row(body: dict) -> dict:
    """把解析结果收敛成业务表结构;图集与视频走同一套字段。"""
    d = body["data"]
    stats = d.get("stats") or {
   }
    source = d.get("source") or {
   }
    return {
   
        "platform": d.get("platform", ""),
        "content_type": d.get("type", ""),
        "title": d.get("title", ""),
        "desc": d.get("desc", ""),
        "cover_url": d.get("cover_url", ""),
        "media_url": d.get("video_url", ""),         # 纯图集时为空串
        "images": d.get("images") or [],             # 元素为字符串
        "author": d.get("author") or stats.get("author_name", ""),
        "like_count": stats.get("like_count", 0),    # 缺项为 0
        "play_count": stats.get("play_count", 0),
        "publish_time": stats.get("publish_time", ""),
        # 以下三项请在最终用户可见界面展示
        "source_platform": source.get("platform_label", ""),
        "source_author": source.get("author_name", ""),
        "copyright_notice": source.get("copyright_notice", ""),
    }

if __name__ == "__main__":
    row = to_material_row(parse_with_retry("https://v.douyin.com/xxxxx/"))
    print(json.dumps(row, ensure_ascii=False, indent=2))

Node.js 版本(Node 18+ 内置 fetch)

// parse.mjs —— XIAOAPIS_KEY=xxx node parse.mjs
const endpoint = "https://xiaoapis.com/api/video/videoparse";

export async function parseVideo(shareText) {
   
  const params = new URLSearchParams({
   
    key: process.env.XIAOAPIS_KEY,
    url: shareText,
    flat: "2",
  });
  const res = await fetch(`${
     endpoint}?${
     params}`, {
   
    signal: AbortSignal.timeout(15000),
  });
  const body = await res.json();
  if (body.code !== 200) {
   
    throw new Error(`code=${
     body.code} msg=${
     body.msg}`);
  }
  return body.data;
}

const data = await parseVideo("https://v.douyin.com/xxxxx/");
console.log(data.title, data.video_url || data.images);

五、返回结构(以下为官方文档示例的精简摘录)

{
   
  "code": 200,
  "msg": "success",
  "data": {
   
    "platform": "xiaohongshu",
    "type": "视频",
    "title": "一年级同学你好!!!",
    "desc": "这个小朋友真的成为小学生了,送到校门口老母亲就飙泪",
    "video_url": "https://sns-video-hs.xhscdn.com/example.mp4",
    "cover_url": "https://sns-img-hw.xhscdn.com/example",
    "images": ["https://sns-img-hw.xhscdn.com/example"],
    "author": "示例作者",
    "video_format": "mp4",
    "stats": {
   
      "like_count": 40,
      "comment_count": 23,
      "share_count": 4,
      "play_count": 0,
      "collect_count": 9,
      "publish_time": "2026-08-30 08:59:24"
    },
    "video_list": [
      {
    "quality": "高清", "url": "https://sns-video-hs.xhscdn.com/example.mp4", "size": "", "resolution": "1080x1920" }
    ],
    "source": {
   
      "platform_label": "小红书",
      "copyright_notice": "本内容版权归原作者及原平台所有……",
      "usage_restriction": "仅供个人备份、内容审核、数据分析、学术研究等合理使用场景……"
    }
  },
  "exec_time": 2.18,
  "ip": "1.2.3.4"
}
目录
相关文章
|
2月前
|
人工智能 自然语言处理 安全
生成式 AI 驱动冒名欺诈的演化机理与治理路径研究
本文基于美联社2026年调查,剖析生成式AI驱动冒名欺诈的技术演化、识别困境与社会危害,指出传统“识假”防御已失效。提出技术检测、平台责任、金融风控、法律规制、公众素养五维协同治理框架,强调防御重心应从“识别真假”转向“验证来源+阻断资金”。
191 1
|
4月前
|
自然语言处理 运维 算法
基于阿里云 OpenSearch 行业算法版的海外电商智能搜索实践
本文档详述东南亚电商巨头GoTerra从自建Elasticsearch迁移至阿里云OpenSearch行业算法版的全链路实践,涵盖多语言语义理解、向量检索、低延迟优化(P99延迟降幅超70%)、弹性成本控制与安全加固,提供可复用的企业级智能搜索升级范式。
502 0
|
17天前
|
弹性计算 人工智能 双11
2026年阿里云双11活动专属优惠,4核8G ECS云服务器各付费模式费用一览
2026年阿里云双十一最大的认知纠偏是——"新用户抢骨折价,老用户只能原价续费"是个误解。阿里云轻量应用服务器、阿里云 ECS 云服务器 、阿里云 EGS GPU 云服务器、百炼大模型服务平台四大产品线均为老用户开设了独立活动专区,续费同价、阶梯折扣、消费满返三重福利叠加,最高可锁到2030年。 4核8G 阿里云 ECS 云服务器 年付898元起,叠加券后可至673元;五年总成本不过四千出头,月均不到70元——这比你每天一杯咖啡还便宜。而如果贪图38元秒杀款却年年续费原价,长期反而更贵。续费同价四个字,才是2026年双十一真正的底价承诺。 活动持续至11月30日,入口有二:登录控制台首页横
253 1
|
29天前
|
弹性计算 关系型数据库 开发者
中国香港云服务器选择轻量还是ECS?阿里云香港地域轻量和ECS区别对比
阿里云香港服务器选轻量还是ECS?轻量适合个人/学生建站、测试,开箱即用、免备案、套餐价稳;ECS面向企业级场景,免备案+多可用区+高可用+灵活网络与计费,性能与扩展性更强。按业务规模与技术需求理性选择。阿里云服务器官方活动:https://t.aliyun.com/U/i0xS6v
228 1
|
存储 运维 容灾
容灾的架构分析和容灾选择策略
容灾的架构分析和容灾选择策略
容灾的架构分析和容灾选择策略
|
移动开发 HTML5
HTML5 新的 Input 类型3
`&lt;input type=&quot;month&quot;&gt;` 允许用户选择一个月份,适用于需要指定月份和年的场景。示例:生日 (月和年)。 `&lt;input type=&quot;number&quot;&gt;` 用于需要数值输入的场合,可设置数值范围等限制。示例:数量 (1 到 5 之间)。支持 `disabled`, `max`, `min` 等属性以增强功能。
|
人工智能 搜索推荐 API
开源2.0|从事视频剪辑的“熬者们”,自动化剪辑工具 FunClip请收好
开源2.0|从事视频剪辑的“熬者们”,自动化剪辑工具 FunClip请收好
开源2.0|从事视频剪辑的“熬者们”,自动化剪辑工具 FunClip请收好
|
存储 运维 Kubernetes
Kubernetes日志采集原理全方位剖析
本文将主要介绍SLS对于Kubernetes日志采集的基本原理,便于大家在实践中能够更好的规划使用方式。
3762 0
Kubernetes日志采集原理全方位剖析
|
存储 SQL 机器学习/深度学习
OSS加速器最佳实践-总述篇
OSS加速器最佳实践(总述篇)本最佳实践提供OSS加速器相关的信息和适合的场景,面向对oss和数据湖相关技术有一定了解的开发者。     大家可以通过这俩篇先做一些了解相关文档:《配置OSS加速器》https://help.aliyun.com/document_detail/190726.html《OSS加速器介绍》https://developer.aliyun.com/article/780
1424 1
OSS加速器最佳实践-总述篇
|
XML 负载均衡 Java
spring boot 和spring cloud 的简介
spring boot 和spring cloud 的简介
spring boot 和spring cloud 的简介

热门文章

最新文章