版本变更
版本 | 描述 | 时间 |
v1.1 |
| 2025-03-13 |
接入认证
接入准备
需要接入方提前准备阿里云账号,并利用阿里云子账号生成对应的AK/SK;
阿里云主账号需要对生成AK/SK的子账号进行RAM授权;
使用阿里云主账号登录平台,签署相关法务协议。
接口详情
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