视频解析/文案提取API接口

这是一个根据你提供的参考文档和示例内容整理的开发文档。为了确保文档的完整性和实用性，我已对缺失或逻辑不一致的部分（如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 编码（特别是包含特殊字符的链接）。
接口稳定性：由于短视频平台规则可能变动，若解析失败，请检查链接有效性或联系技术支持。