Skip to content
Platform / Docs / Short-video script extraction API
Sign up Console →

API Reference

Short-video script extraction API

POST video-copy-api ID 28

Extract script or caption text from a short video for rewriting or a knowledge base.

POST https://xiaoapis.com/api/video/text
Get an API key Console / try it Open Markdown

Overview

  • 文案/字幕提取
  • JSON 返回
  • 可与解析接口组合

Use cases

  • 视频转文案
  • 内容改写
  • 知识库入库
Conventions
  • Gateway · https://xiaoapis.com
  • Auth · send key (query or JSON body, as this API specifies)
  • Response · JSON. Check the business code and the HTTP status, not only HTTP 200

Authentication

Send the platform API key (query parameter key or JSON field key, as this page specifies). Create one in API key management.

POST https://xiaoapis.com/api/video/text
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

Request example

https://xiaoapis.com/api/video/text?key=你的密钥

Details

请求HEADER：

名称值
Content-Typeapplication/x-www-form-urlencoded;charset:utf-8;

请求参数说明：

名称必填类型示例值说明
key是string35kj5jnlj53453kl5j43nj5接口密钥,在控制台->密钥管理查看
content是string https://#/#视频或音频url，支持格式：mp3、mp4、wav、webm、aac、flac、m4a、mov、mkv、ogg、opus、amr、avi、flv、mpeg、wma、wmv等链接，若失败可通过录屏获取视频，最大2GB，最大时长12小时。

请确认您拥有该内容的权利：

使用您不拥有的视频可能违反版权法。继续操作即表示您确认此内容是您自己的原创作品。

taskId否string3c1d56f8-bd7e-4d15-8112-f212222cd4a6查询任务ID，不填是提交任务，填写任务ID是查询任务
language否stringzh-CN选填默认自动识别语言，支持语言：zh: 中文、en: 英文、ja: 日语、yue: 粤语、ko: 韩语、de：德语、fr：法语、ru：俄语等

返回参数说明：

名称类型说明
codeint状态码
msgstring状态信息
datastring请求结果数据集
-taskIdstring任务 ID
-statusstring 状态
-resultTextstring视频文案
-authorstring作者
-durationstring时长
-videoDescstring视频描述
-creditCoststring积分
debugstring/array调试数据
exec_timefloat执行耗时
user_ipstring客户端IP

Response example

<p>{</p><p>&quot;code&quot;: 200,</p><p>&quot;msg&quot;: &quot;success&quot;,</p><p>&quot;data&quot;: {</p><p>&quot;taskId&quot;: &quot;792b1cd3-a474-4f59-9344-cd02efe724fd&quot;,</p><p>&quot;status&quot;: &quot;completed&quot;,</p><p>&quot;resultText&quot;: &quot;美国狂砸7,000亿搞 AI，发现电网撑不住了。短短三个交易日，美国太空探索技术公司 Spacex 的股价上涨了近50%，市值一路狂飙，跻身全球前五。但美国科技巨头对 AI 算力的渴求面临严峻的现实掣肘。数据显示，2026年，美国科技巨头用于 AI、基础设施等在内的资本支出超过7,000亿美元。专家表示，目前美国发展人工智能的最大瓶颈是急剧膨胀的算力需求与落后的电网基础设施之间的矛盾。&quot;,</p><p>&quot;author&quot;: &quot;长江云新闻&quot;,</p><p>&quot;videoDesc&quot;: &quot;美国狂砸7000亿搞AI，发现电网撑不住了&quot;,</p><p>&quot;duration&quot;: 0.5,</p><p>&quot;creditCost&quot;: 0.5</p><p>},</p><p>&quot;exec_time&quot;: 2.015858,</p><p>&quot;ip&quot;: &quot;112.49.185.70&quot;</p><p>}</p><p><br/></p>

FAQ

如何通过 API 获取视频文案？

调用短视频提取文案接口，按文档传入视频相关参数与 API Key，从返回中读取文案字段。

和全平台视频解析有什么区别？

解析侧重元数据与媒体地址；文案提取侧重口播/字幕文本。

可以和语音转文字一起用吗？

可以。若已有音视频文件，也可直接使用语音转文本接口做 ASR。

返回格式是什么？

JSON；文案字段结构以文档示例为准。

适合什么业务？

爆款文案拆解、改写再创作、字幕校对与知识库建设。

失败常见原因？

链接无效、无可用文案、源内容限制或 Key/额度问题。

Full console doc (with the debugger):/doc/28