新手开发指南：短视频提取文案API
接口名称：短视频提取文案解析
服务商：酷虎云API开放平台
适用场景：解析抖音等短视频链接，提取视频中的语音并转换为文字文案。
准备工作：获取API密钥 (Key)
在调用任何API之前，你必须拥有一个专属的接口密钥。
操作步骤：
访问 酷虎云API官网 并登录/注册账号。
进入 "控制台" 或 "密钥管理" 页面。
申请或查看你的 API Key（一串类似 35kj5jnlj53453kl5j43nj5 的字符串）。请妥善保管此密钥。
接口核心信息
请求参数说明
你需要向接口发送以下参数来获取数据：
参数名 必填 类型 说明
key 是 string 你的接口密钥 (API Key)。
content 是 string 视频地址信息（例如：抖音的分享链接）。
taskId 否 string 任务ID。留空表示提交新任务；填写ID表示查询该任务的处理结果。
language 否 string 语种选择。默认 zh-CN (中文)，支持 en-US (英语)、ja-JP (日语)、ko-KR (韩语) 等。
快速接入示例
以下是几种常见编程语言的请求示例代码（请将代码中的 你的接口密钥 替换为你实际的 Key）：
Python 示例 (使用 requests 库)
import requests
url = "#/api/aibasic/videoanalysis"
构建请求参数
payload = {
'key': '你的接口密钥',
'content': '#/xxxxxx/', # 视频链接
'taskId': '', # 留空提交新任务
'language': 'zh-CN'
}
headers = {
'Content-Type': 'application/x-www-form-urlencoded;charset:utf-8'
}
发送 POST 请求
response = requests.post(url, data=payload, headers=headers)
打印结果
print(response.text)
JavaScript (使用 Fetch)
const url = '#/api/aibasic/videoanalysis';
const params = new URLSearchParams();
params.append('key', '你的接口密钥');
params.append('content', '#/xxxxxx/');
params.append('taskId', '');
params.append('language', 'zh-CN');
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded;charset:utf-8'
},
body: params
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
PHP 示例
<?php
API_KEY = '你的接口密钥';
API_URL = '/api/aibasic/videoanalysis';
post_data = array(
'key' => API_KEY,
'content' => 'https://#/xxxxxx/',
'taskId' => '',
'language' => 'zh-CN'
);
ch = curl_init();
curl_setopt(ch, CURLOPT_URL, API_URL);
curl_setopt(ch, CURLOPT_POST, true);
curl_setopt(ch, CURLOPT_POSTFIELDS, http_build_query(post_data));
curl_setopt(ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt(ch, CURLOPT_SSL_VERIFYPEER, false);
response = curl_exec(ch);
curl_close(ch);
echo response;
?>
返回结果解析
当请求成功时，接口会返回 JSON 格式的数据。
成功返回示例：
{
"code": 200,
"msg": "success",
"data": {
"taskId": "3c1d56f8-bd7e-4d15-8112-f212222cd4a6",
"status": "completed",
"resultText": "谁能胜任逞强...", // 提取的文案内容
"author": "视频作者名",
"videoDesc": "视频的原始描述",
"duration": 0.3,
"creditCost": 0.3
},
"exec_time": 2.705944
}
返回字段说明：
code: 状态码。200 表示成功。
msg: 状态信息描述。
data: 结果数据集。
resultText: 核心字段，即视频提取出的文字内容。
taskId: 任务ID，可用于轮询查询结果（如果是异步任务）。
exec_time: 执行耗时。
常见错误码
错误码 说明 解决方案
400 参数传递不正确 检查 key 和 content 是否为空或格式错误。
403 没有权限 检查你的 API Key 是否正确，或账户是否欠费/被封禁。
500 服务器内部错误 通常是服务端问题，稍后重试或联系客服。
调试建议
先使用在线调试工具：在酷虎云API文档页面通常有"在线调试"功能，你可以先在那里填入参数测试，确认接口可用性。
注意编码：请求头中明确要求了 charset:utf-8，请确保你的请求库或代码没有覆盖此设置，避免中文乱码。
费用说明：该接口按量计费，单价为 0.1元/分钟（视频时长），首次注册通常有免费额度（如10分钟），请留意账户余额。
来源：酷虎抖音文案提取api接口开放平台