新手开发指南：短视频提取文案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接口开放平台