Video understanding and clipping - Public API

Version history

Authentication

Prerequisites

1. Obtain an Alibaba Cloud account, and then use a RAM user to generate an AccessKey pair.

2. The Alibaba Cloud account must grant RAM authorization to a RAM user to generate an AK/SK.

3. Log on to the platform with your Alibaba Cloud account and sign the relevant legal agreements.

API details

1. Submit a video clipping task

API: CreateVideoClipTask

1.1. Request parameters

1.2. Response parameters

2. Batch query video clipping task information

API: BatchGetVideoClipTask

2.1. Request parameters

2.2. Response parameters

Task

Video

3. Get an OSS upload signature

API: GetOssUploadToken

3.1. Request parameters

3.2. Response parameters

SDK download and update

PHP

Reference

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);

// Example for the GetOssUploadToken API
$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

Reference

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);
    // Create a client.
    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("Each clip needs to output a subject, highlight analysis, and detailed interpretation.");
        request.setDescription("This is a video of an online English class where Teacher Xiaoyu is teaching English words.");
        try {
            // Call the API.
            CreateVideoClipTaskResponse response = client.createVideoClipTask(request);
            System.out.println(gson.toJson(response));

            if (response.getStatusCode().equals(200)) {
                System.out.println("The CreateVideoClipTask request was successful.");
            }
        } 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("The batchGetVideoClipTask request was successful.");
            }
        } 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("The getOssToken request was successful.");
        }
    }


}

2.12.0

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>intelligentcreation20240313</artifactId>
  <version>2.12.0</version>
</dependency>