API Reference
短视频提取文案解析 API
POST
video-copy-api
ID 28
从短视频内容中提取文案/字幕类信息,便于改写、知识库与二次创作。
POST
https://xiaoapis.com/api/video/text
概述
- 文案/字幕提取
- JSON 返回
- 可与解析接口组合
适用场景
- 视频转文案
- 内容改写
- 知识库入库
调用约定
- 网关 ·
https://apis.xiaobao.ink - 鉴权 · 请求携带
key(Query 或 JSON Body,以本接口为准) - 回包 · JSON;请同时校验业务码与 HTTP 状态,不要只看 200
鉴权
请求需携带平台 API Key(查询参数 key 或 JSON 字段 key,以本接口说明为准)。在控制台 API Key 管理 创建密钥。
POST https://xiaoapis.com/api/video/text
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://xiaoapis.com/api/video/text?key=你的密钥
详细说明
请求HEADER:
| 名称 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded;charset:utf-8; |
请求参数说明:
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥,在控制台->密钥管理查看 |
| content | 是 | string | https://#/# | 视频或音频url,支持格式:mp3、mp4、wav、webm、aac、flac、m4a、mov、mkv、ogg、opus、amr、avi、flv、mpeg、wma、wmv等链接,若失败可通过录屏获取视频,最大2GB,最大时长12小时。 请确认您拥有该内容的权利: 使用您不拥有的视频可能违反版权法。继续操作即表示您确认此内容是您自己的原创作品。 |
| taskId | 否 | string | 3c1d56f8-bd7e-4d15-8112-f212222cd4a6 | 查询任务ID,不填是提交任务,填写任务ID是查询任务 |
| language | 否 | string | zh-CN | 选填默认自动识别语言,支持语言:zh: 中文、en: 英文、ja: 日语、yue: 粤语、ko: 韩语、de:德语、fr:法语、ru:俄语等 |
返回参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 状态信息 |
| data | string | 请求结果数据集 |
| -taskId | string | 任务 ID |
| -status | string | 状态 |
| -resultText | string | 视频文案 |
| -author | string | 作者 |
| -duration | string | 时长 |
| -videoDesc | string | 视频描述 |
| -creditCost | string | 积分 |
| debug | string/array | 调试数据 |
| exec_time | float | 执行耗时 |
| user_ip | string | 客户端IP |
返回示例
<p>{</p><p>"code": 200,</p><p>"msg": "success",</p><p>"data": {</p><p>"taskId": "792b1cd3-a474-4f59-9344-cd02efe724fd",</p><p>"status": "completed",</p><p>"resultText": "美国狂砸7,000亿搞 AI,发现电网撑不住了。短短三个交易日,美国太空探索技术公司 Spacex 的股价上涨了近50%,市值一路狂飙,跻身全球前五。但美国科技巨头对 AI 算力的渴求面临严峻的现实掣肘。数据显示,2026年,美国科技巨头用于 AI、基础设施等在内的资本支出超过7,000亿美元。专家表示,目前美国发展人工智能的最大瓶颈是急剧膨胀的算力需求与落后的电网基础设施之间的矛盾。",</p><p>"author": "长江云新闻",</p><p>"videoDesc": "美国狂砸7000亿搞AI,发现电网撑不住了",</p><p>"duration": 0.5,</p><p>"creditCost": 0.5</p><p>},</p><p>"exec_time": 2.015858,</p><p>"ip": "112.49.185.70"</p><p>}</p><p><br/></p>
常见问题
如何通过 API 获取视频文案?
调用短视频提取文案接口,按文档传入视频相关参数与 API Key,从返回中读取文案字段。
和全平台视频解析有什么区别?
解析侧重元数据与媒体地址;文案提取侧重口播/字幕文本。
可以和语音转文字一起用吗?
可以。若已有音视频文件,也可直接使用语音转文本接口做 ASR。
返回格式是什么?
JSON;文案字段结构以文档示例为准。
适合什么业务?
爆款文案拆解、改写再创作、字幕校对与知识库建设。
失败常见原因?
链接无效、无可用文案、源内容限制或 Key/额度问题。
相关接口
完整控制台文档(含调试台):/doc/28