视频理解切片-对外API

更新时间:2025-03-27 02:46:05

版本变更

版本

描述

时间

v1.1

  1. 提交视频切片任务

  2. 批量查询视频切片任务

2025-03-13

接入认证

接入准备

  1. 需要接入方提前准备阿里云账号,并利用阿里云子账号生成对应的AK/SK;

  2. 阿里云主账号需要对生成AK/SK的子账号进行RAM授权;

  3. 使用阿里云主账号登录平台,签署相关法务协议。

接口详情

1. 提交视频切片任务

API: CreateVideoClipTask

1.1. 入参

参数名称

类型

是否必选

说明

示例值

ossKeys

Array

视频oss地址,最多支持10个视频、最大500M、最长两小时、仅支持mp4格式

["api/test.mp4", "api/test1.mp4"]

requirement

String

切片要求:最长200个字符

视频中出现XX人物画面的内容进行切片

description

String

视频内容说明

这是一个XXX背景的视频

1.2. 出参

参数名称

类型

说明

示例值

taskId

String

任务id

11

2. 批量查询视频切片任务信息

API: BatchGetVideoClipTask

2.1. 入参

参数名称

类型

是否必选

说明

示例值

taskIdList

Array

任务id集合

["11","22"]

2.2. 出参

参数名称

类型

说明

示例值

taskList

Array

视频切片详情

[{},{}]

Task

参数名称

类型

说明

示例值

taskId

String

任务id

11111

status

String

状态: FINISHED - 任务已经结束

PENDING - 任务待处理

NOT_EXIST - 任务不存在

FINISHED

totalToken

Long

token

4333

totalDuration

Double

总时长单位毫秒

213000

videoList

Array

视频切片详情

[{},{}]

Video

参数名称

类型

说明

示例值

title

String

切片主题

新车上市

description

String

切片内容描述

新车上市促销

videoUrl

String

视频浏览地址

http://111.com

videoDownloadUrl

String

视频下载地址

http://111.com

videoName

String

原始视频素材名称

测试视频

beginTime

Integer

相对原视频的切片开始时间点,单位毫秒

0

endTime

Integer

相对原视频的切片结束时间点,单位毫秒

12000

errorMsg

String

视频切片失败的原因

任务超时

3. 获取oss上传签名

API: GetOssUploadToken

3.1. 入参

参数名称

类型

是否必选

说明

示例值

fileName

String

需要上传的文件名称(文件名称不要重复)

测试视频

fileType

String

上传文件的使用场景:VideoClip-视频切片

VideoClip

uploadType

String

上传方式:1-签名URL上传

1

3.2. 出参

参数名称

类型

说明

示例值

url

String

文件上传url地址

http://oss.xxxxx

key

String

oss key

api/test.mp4

SDK下载及更新

PHP

接入参考

require 'vendor/autoload.php';
use AlibabaCloud\SDK\Imarketing\V20220704\Models\GetOssUploadSignatureRequest;
use AlibabaCloud\SDK\IntelligentCreation\V20240313\IntelligentCreation;
use Darabonba\OpenApi\Models\Config as AlibabaConfig;

$config = new AlibabaConfig();
$config->accessKeyId = '****';
$config->accessKeySecret = '****';
$config->endpoint = "intelligentcreation.cn-zhangjiakou.aliyuncs.com";

$intelligentCreationClient = new IntelligentCreation($config);

// GetOssUploadToken 接口示例
$request = new GetOssUploadSignatureRequest();
$request->fileName = 'xxx.png';
$request->fileType = "ProductImage";
try {
    $response = $intelligentCreationClient->getOssUploadToken($request);
    var_dump($response->toMap());
} catch (TeaError $e) {
    Log::error($e);
}

2.12.0

composer require alibabacloud/intelligentcreation-20240313 2.12.0

Java

接入参考

package com.aliyun.intelligentcreation20240313;

import com.aliyun.intelligentcreation20240313.models.*;
import com.aliyun.tea.TeaException;
import com.aliyun.teaopenapi.models.Config;
import com.google.gson.Gson;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;

public class TestVideoClip {

    String url = "intelligentcreation.cn-zhangjiakou.aliyuncs.com";
    String ak = ""; 
    String sk = "";
    Config config = new Config().setAccessKeyId(ak)
            .setAccessKeySecret(sk)
            .setEndpoint(url);
    // 创建客户端
    Client client = new Client(config);

    public TestVideoClip() throws Exception {
    }


    public static void main(String[] args) throws Exception {
        TestVideoClip testVideoClip = new TestVideoClip();
       testVideoClip.getOssToken();
       testVideoClip.CreateVideoClipTask();
        testVideoClip.batchGetVideoClipTask();
    }


    public void CreateVideoClipTask() throws Exception {
        Gson gson = new Gson();

        CreateVideoClipTaskRequest request = CreateVideoClipTaskRequest.build(new HashMap<>());
        List<String> ossKeys = new ArrayList<>();
        ossKeys.add("video_slicing_tmp/openApi/1539704706413278/1740722903556-test01.mp4");
        request.setOssKeys(ossKeys);
        request.setRequirement("每一个切片需要输出选择此切片的主题、爆点分析和详细解读");
        request.setDescription("下面是一个英语网课视频,小鱼老师正在教大家学习英语单词");
        try {
            // 请求接口
            CreateVideoClipTaskResponse response = client.createVideoClipTask(request);
            System.out.println(gson.toJson(response));

            if (response.getStatusCode().equals(200)) {
                System.out.println("CreateVideoClipTask 请求成功");
            }
        } catch (TeaException e) {
            System.out.println(gson.toJson(e));
        }
    }

    public void batchGetVideoClipTask() throws Exception {
        Gson gson = new Gson();

        BatchGetVideoClipTaskRequest request = BatchGetVideoClipTaskRequest.build(new HashMap<>());
        List<String> ossKeys = new ArrayList<>();
        ossKeys.add("868940315698937856");
        ossKeys.add("868939847545192448");
        ossKeys.add("868135095230611456");
        ossKeys.add("868946929948655616");
        ossKeys.add("869300521721544704");
        ossKeys.add("11");
        request.setTaskIdList(ossKeys);

        try {
            BatchGetVideoClipTaskResponse response = client.batchGetVideoClipTask(request);
            System.out.println(gson.toJson(response));

            if (response.getStatusCode().equals(200)) {
                System.out.println("batchGetVideoClipTask 请求成功");
            }
        } catch (TeaException e) {
            System.out.println(gson.toJson(e));
        }
    }


    public void getOssToken() throws Exception {
        Gson gson = new Gson();
        GetOssUploadTokenRequest request = new GetOssUploadTokenRequest();
        request.setFileName("test01.mp4");
        request.setFileType("VideoClip");
        request.setUploadType(1);

        GetOssUploadTokenResponse response = client.getOssUploadToken(request);
        System.out.println(gson.toJson(response));
        if (response.getStatusCode().equals(200)) {
            System.out.println("getOssToken 请求成功");
        }
    }


}

2.12.0

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>intelligentcreation20240313</artifactId>
  <version>2.12.0</version>
</dependency>
  • 本页导读 (0)
  • 版本变更
  • 接入认证
  • 接入准备
  • 接口详情
  • 1. 提交视频切片任务
  • 2. 批量查询视频切片任务信息
  • 3. 获取oss上传签名
  • SDK下载及更新
  • PHP
  • 接入参考
  • 2.12.0
  • Java
  • 接入参考
  • 2.12.0