统一响应 {"code":0,"message":"ok","data":…},成功 code=0;失败时 code 与 HTTP 状态码一致。
下方每个接口都可直接调试:填参数 → 点「发送请求」→ 查看真实响应。
POST
/api/v1/hot-extract
提取(同步)
传入抖音/快手分享链接或分享文案,解析媒体直链并用百炼 paraformer-v2 转写为文案。
尚未发送请求
GET
/api/v1/hot-extracts
历史列表
分页查询提取历史,支持按平台与关键词过滤。
尚未发送请求
GET
/api/v1/hot-extracts/{extract_no}
单条详情
按对外编号查询单条记录。
尚未发送请求
GET
/api/v1/hot-extracts/{extract_no}/download
下载视频
服务端代理流式转发无水印视频,返回 video/mp4 并带下载文件名(规避跨域 / 防盗链)。
请求参数说明
POST /api/v1/hot-extract · Body(application/json)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
share_text | string | 是 | 抖音/快手分享链接或完整分享文案,≤5000 字 |
name | string | 否 | 任务名,≤100 字,便于历史检索 |
GET /api/v1/hot-extracts · Query
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
page | int | 否 | 1 | 页码 |
per_page | int | 否 | 15 | 每页条数,1~50 |
platform | string | 否 | - | douyin / kuaishou |
keyword | string | 否 | - | 模糊匹配 title / author / name |
GET /api/v1/hot-extracts/{extract_no} · Path
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
extract_no | string(26) | 是 | 对外编号 ULID |
GET /api/v1/hot-extracts/{extract_no}/download · Path
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
extract_no | string(26) | 是 | 对外编号 ULID;返回 video/mp4 流,带下载文件名 |
调用示例
cURL
# 1) 提取(同步,最长约 3 分钟)
curl -X POST __HOST__/api/v1/hot-extract \
-H "Content-Type: application/json" \
-d '{"share_text":"https://v.douyin.com/xxxx/","name":"demo"}'
# 2) 历史列表
curl "__HOST__/api/v1/hot-extracts?page=1&per_page=15&platform=douyin&keyword=%E4%B8%89%E8%A7%92%E6%A2%85"
# 3) 单条详情
curl "__HOST__/api/v1/hot-extracts/01M3RSGPSVN3BH1XHF9XJK5ASZ"
# 4) 下载视频(-OJ 保留服务端文件名)
curl -OJ "__HOST__/api/v1/hot-extracts/01M3RSGPSVN3BH1XHF9XJK5ASZ/download"
PHP
$ch = curl_init('__HOST__/api/v1/hot-extract');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 320, // 同步转写,超时要够长
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'share_text' => 'https://v.douyin.com/xxxx/',
'name' => 'demo',
], JSON_UNESCAPED_UNICODE),
]);
$res = json_decode(curl_exec($ch), true);
if (($res['code'] ?? -1) === 0) {
echo $res['data']['caption']; // 文案
echo $res['data']['direct_video_url']; // 视频直链
} else {
echo '失败:' . $res['message'];
}
JavaScript (fetch)
const res = await fetch('/api/v1/hot-extract', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ share_text: 'https://v.douyin.com/xxxx/', name: 'demo' })
});
const json = await res.json();
if (json.code === 0) {
console.log(json.data.caption); // 文案
console.log(json.data.direct_video_url); // 视频直链
} else {
console.error(json.message);
}
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
id | int | 自增主键 |
extract_no | string(26) | 对外编号(ULID),用于查详情 |
name | string|null | 任务名 |
platform | string | douyin / kuaishou |
title | string|null | 视频标题 |
author | string|null | 作者昵称 |
cover_url | string|null | 封面地址 |
video_url | string|null | 无水印视频直链(原始解析结果) |
direct_video_url | string|null | 302 解析后的裸 mp4 直链 |
audio_url | string|null | 音频直链(转写优先使用) |
caption | string|null | 提取出的文案 |
asr_model | string|null | 转写模型,默认 paraformer-v2 |
status | string | 当前恒为 success |
created_at | string | 创建时间 Y-m-d H:i:s |
错误码
| code / HTTP | 场景 | 示例 message |
|---|---|---|
422 | share_text 缺失 | 请传入分享链接或分享文案 |
422 | 文案里没有链接 | 未从分享文案中提取到链接 |
422 | 非抖音/快手 | 当前仅支持抖音和快手分享链接 |
422 | 无有效语音 | ASR 转写失败:该视频音频中未检测到有效语音片段… |
404 | 详情不存在 | 记录不存在 |
429 | 触发限流(60/分钟) | Too Many Attempts. |
500 | 服务端异常 | 非预期错误(见服务端日志) |