视频解析 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"
}
目录
相关文章
|
5天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
6844 15
|
5天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
2293 8
|
8天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
8天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
3天前
|
传感器 安全 区块链
Windows 电脑运行安卓应用教程:开源工具 ApkStart 双击 APK 即装、独立窗口运行
ApkStart 是一款开源Windows工具,让安卓APP像原生软件一样运行:双击APK即安装、生成真实图标、独立窗口启动、开始菜单可搜索。无需传统模拟器,内置QEMU运行时,支持数据互通、ARM兼容与命令行操作。(239字)
|
21天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
10167 59
|
4天前
|
人工智能 弹性计算 开发工具
零成本玩各大模型!DeepSeek Harness dsh-our-free-model 插件,13 个厂商模型直接用
总结一下:装这个插件,你不用注册、不用绑卡、不用填一个 Key,就能在 DeepSeek Harness 里用上 DeepSeek V4.1 Flash、Kimi K3 这一批前沿模型,而且是白嫖的、还不限量。三步搞定:下载插件,复制包含 `package.json` 的插件目录路径,在「添加插件」里粘贴路径安装并重启。无论是在阿里云 ECS 上通过命令行部署的 Web 版,还是本地的 Electron 桌面端,都能顺利跑通,快速搭建一套零成本的免费模型使用环境。
1047 0
|
7天前
|
Linux API iOS开发
【DSH】DeepSeek Harness新手保姆教程(下载+安装+配置+使用,2026最新实测)
DeepSeek Harness(dsh)是DeepSeek AI开源的智能体框架,秉持“一切皆插件”理念,支持读文件、改代码、跑命令、处理表格、联网搜索等操作。免费开源,兼容Windows/macOS/Linux,提供桌面端与网页端,可灵活安装插件扩展能力。
|
15天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
3480 9

热门文章

最新文章