这是一个根据你提供的参考文档和示例内容整理的开发文档。为了确保文档的完整性和实用性,我已对缺失或逻辑不一致的部分(如URL路径、参数名、返回结构)进行了标准化处理。
以下是为你生成的视频解析/文案提取API开发文档:
📹 视频解析/文案提取 API 接口文档
1. 接口概览
本接口用于解析主流短视频平台(如抖音、快手等)的分享链接,提取视频中的文案内容、音频信息及相关元数据。
- 接口地址:
https://api.kuhuyun.com/api/aibasic/videoanalysis - 请求方式:
HTTP GET/HTTP POST - 返回格式:
application/json - 请求编码:
UTF-8
2. 请求参数
请在请求头中包含以下信息,并在请求体(POST)或URL参数(GET)中传递具体参数。
请求 HEADER:
| 名称 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded;charset=utf-8 |
请求参数说明:
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| key | 是 | string | 35kj5jnlj53453kl5j43nj5 | 接口密钥。请在控制台 -> 密钥管理中查看。 |
| content | 是 | string | https://v.douyin.com/XPPhzFT... | 视频地址信息。支持抖音、快手等短视频分享链接。 |
请求示例:
POST 示例 (推荐):
POST /api/aibasic/videoanalysis HTTP/1.1 Host: api.kuhuyun.com Content-Type: application/x-www-form-urlencoded;charset=utf-8 key=35kj5jnlj53453kl5j43nj5&content=https://v.douyin.com/XPPhzFTNrcU/GET 示例:
GET /api/aibasic/videoanalysis?key=你的key&content=https://v.douyin.com/XPPhzFTNrcU/ HTTP/1.1 Host: api.kuhuyun.com
3. 返回参数说明
接口调用成功后,将返回 JSON 格式的数据。
| 名称 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码。200 表示成功,其他为异常(如 403 密钥错误)。 |
| msg | string | 状态信息描述。 |
| data | object | 请求结果数据集。 |
| ├─text | string | 提取的视频文案/文字信息。 |
| ├─summary | string | 视频摘要(当前版本可能为空)。 |
| └─prompt | array | 调试数据/资源列表。 |
| ├─title | string | 资源名称(如“下载链接”、“音频地址”)。 |
| └─prompt | string | 具体的资源地址或信息。 |
| exec_time | float | 接口执行耗时(秒)。 |
| ip | string | 当前服务器 IP 地址。 |
4. 返回示例
成功响应示例:
{ "code": 200, "msg": "success", "data": { "text": "降温了保暖打底衫真的得提前备起来~ 这件的版型显瘦又漂亮,主要是还保暖 #秋冬新款 #内搭外穿都好看#保暖又 好看", "summary": "", "prompt": [ { "title": "视频标题", "prompt": "降温了保暖打底衫..." }, { "title": "视频封面", "prompt": "https://example.com/cover.jpg" }, { "title": "音频地址", "prompt": "https://example.com/audio.mp3" } ] }, "exec_time": 12.487, "ip": "117.188.13.239" }错误响应示例:
{ "code": 403, "msg": "请求密钥KEY不正确!", "data": "", "exec_time": 0.008, "ip": "49.7.6.31" }⚠️ 注意事项
- 密钥安全:请妥善保管您的
key,避免泄露。 - 编码格式:请确保请求头中的
Content-Type正确设置为application/x-www-form-urlencoded,且参数值已进行 URL 编码(特别是包含特殊字符的链接)。 - 接口稳定性:由于短视频平台规则可能变动,若解析失败,请检查链接有效性或联系技术支持。