视频切片 · 销豹 AI API

长视频,
拆成高光短视频。

一条长视频进去,几条能单独发布的短视频出来。

  • 你要给一条公网视频地址
  • 你要选场景、切法、时长
  • 你会拿到主题、概要、文件地址

先选场景

五个类型,只填一个编号

这个编号就是 scene_id。选最接近的一类,接口按这类内容去找高光。

填 0

通用

产品演示、课程、活动回放

没有更贴的类型时填 0。

填 1

直播

讲解、卖点和成交瞬间

直播回放填 1。

填 2

体育赛事

进球、回合和关键判罚

比赛录像填 2。

填 3

访谈演讲

观点、金句和问答

长演讲、访谈填 3。

填 4

影视综艺

高能片段和话题点

影视、综艺填 4。

再选切法

两种切法,只选一种

这个值就是 slice_method。0 是原样截一段,1 是把多段拼成一条。

填 0

连续片段

从原片里完整截一段

讲述顺序保持不变。

填 1

智能拼接

把多段高光收成一条

按同一个主题拼在一起。

时长填其中一档,单位是秒。字段名是 slice_length。不传时大约按 30~180 秒来切。

  • 30~60
  • 60~90
  • 90~120
  • 120~180
  • 180~300
  • 300

然后调用

两次请求就完成

先创建,记住 task_id,再查询。密钥只放在你自己的服务端。

  1. 1
    准备一条公网地址

    要的是 URL,不是本地文件。

    自有文件先上传到用户文件空间,再把返回的地址拿来提交。

  2. 2
    创建任务,记下 task_id

    POST /api/video/clip

    带上地址、场景、切法和时长。成功时返回的就是下一步要用的任务号。

  3. 3
    查到完成,再取文件

    state 为 1 时,读 file_url。

    GET /api/video/clip_taskquery,带上刚才的 task_id。每条结果还有主题 theme 和概要 summary。

代码示例

点语言名切换。每种语言都是同一件事:先创建,再用 task_id 查询。

<?php
$apiKey = '你的密钥';
$body = json_encode([
    'url' => 'https://example.com/video.mp4',
    'scene_id' => '1',
    'slice_method' => 0,
    'slice_length' => '30~60',
], JSON_UNESCAPED_UNICODE);

$create = curl_init('https://xiaoapis.com/api/video/clip?key=' . rawurlencode($apiKey));
curl_setopt_array($create, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
]);
$created = json_decode(curl_exec($create), true);
curl_close($create);

$taskId = $created['data']['task_id'];
$query = 'https://xiaoapis.com/api/video/clip_taskquery?key=' . rawurlencode($apiKey)
    . '&task_id=' . rawurlencode($taskId);
$result = json_decode(file_get_contents($query), true);

print_r($result['data']['result']);

别踩这四条

不满足,任务会直接失败

下面四条是硬限制。价格和免费额度以接口文档为准。

声音 视频必须带音频

没有音轨就识别不到内容,任务会失败。

大小 5 小时内,4GB 内

时长和体积只要超一条,就会被拒绝。

地址 5 分钟内要下完

必须是 http 或 https,最长 512 字。路径没有扩展名时补 extension。

费用 按整段视频计,不按条数

20 点/分钟,约 0.2 元/分钟。切出 3 条也只按原片时长算一次。

按这个顺序

先创建,再查询

两个任务号不能混用。查询只认这次切片返回的 task_id。

第 1 步 · 创建 POST /api/video/clip。交出地址和三个选择,拿回 task_id。 文档 /doc/7 · Markdown
第 2 步 · 查询 GET /api/video/clip_taskquery。state 为 1 时,从 result 取 file_url。 文档 /doc/8 · Markdown

切片文件地址可以继续交给智能剪辑,做混剪或包装。

问答

接入时最常对上的几件事

这里只写本接口已经公开的行为。价格、额度和频率以文档页和控制台为准。

怎么完成一次切片?

准备公网视频地址,调用 AI 视频切片创建任务,拿到 task_id 后调用任务查询。state 为 1 时,从 result 读取每条切片的主题、概要、时间和文件地址。

场景、方式和时长怎么填?

scene_id 用 0 到 4,对应通用、直播、体育赛事、访谈演讲、影视综艺。slice_method 为 0 是连续片段,为 1 是智能拼接。slice_length 填时长档,例如 30~60。默认时长档是 30~180。

查询结果里有什么?

每条结果包含 start、end、duration、file_url、theme、summary。start 和 end 的单位是毫秒,file_url 是这条切片的下载地址。

什么情况会失败?

地址下载失败、文件损坏或格式不对、超出大小、处理超时,或没有识别到有效语音,state 会是负数。处理中常见为排队、准备、等待和处理。

切片之后还能做什么?

file_url 可以直接分发,也可以作为素材交给智能剪辑,做口播混剪、新闻混剪或视频包装。

拿一条视频地址就能试

文档里有参数和错误码。还没有密钥时,先在控制台创建。