阿里安全开放平台-阿里聚安全

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
videos	RawSingleVideo []	必须		最大列表长度：1000	待推送的视频数据
└ release_time Number 可选 1562256939000 发布时间，unix时间戳，单位毫秒 └ tag_ids Number [] 可选 10321 系统标签ID，取值参见文档说明 └ charge_type Number 必须 0 付费类型 0-免费、1-VIP免费、2-单点、3-用券 └ album_id String 可选 100001 所属视频集ID └ description String 可选视频介绍视频描述信息 └ language String 可选英语语言 └ like_count Number 可选 3000 点赞数 └ actor_name String [] 可选刘德华演员 └ title String 必须视频标题视频标题 └ play_url String 可选 {"1080P":"http://abc.mp4"} 播放链接，Map，key为support_definition的值 └ duration Number 必须 500 视频时长，单位:秒 └ is_exclusive Number 可选 0 是否独播 0-非独播 1-独播 └ sub_title String 可选子标题子标题 └ valid_end_time Number 可选 1562256939000 失效时间,unix时间戳,单位:毫秒,为空则永不失效 └ director_name String [] 可选张艺谋导演 └ alias String [] 可选别名1 别名 └ id String 必须 10001 视频ID,不同的专辑间也要保证唯一 └ forward_count Number 可选 3000 转发量 └ area String 可选中国区域 └ v_cover_url String 可选 http://c.jpg 视频封面(竖图296 * 440，根据搜索规则，提供竖图用户搜索时可优先搜索到此内容) └ common_cate_id Number 可选 80021002 系统类目ID，取值范围见文档 └ valid_start_time Number 可选 1562256939000 生效时间,unix时间戳,单位:毫秒,为空则立即生效 └ support_definition String [] 必须 480P 支撑的分辨率 └ producer_name String [] 可选出品人出品人 └ collect_count Number 可选 3000 收藏量 └ oupgc_type String 必须 PGC 视频来源类型，PGC/UGC/OGC └ comment_count Number 可选 3000 评论量 └ cover_url String 必须 http://d.jpg 视频封面(横图，图片尺寸是295 * 167) └ play_count Number 可选 3000 播放量 └ uploader_name String [] 可选上传者上传者名称 └ order_index Number 可选 100 视频在所属视频集中的排序号 └ content_score Number 可选 10 内容质量评分 └ operation String 必须 ADD 操作类型ADD/DELETE/UPDATE └ suggest_max_price Number 可选 1200 建议最高零售价(单位:分) └ suggest_min_price Number 可选 1200 建议最低零售价(单位:分) └ cost_price Number 可选 1000 成本价(单位:分) └ audition_second Number 必须 180 试看秒数，若支持试看填1，否则填0

名称	类型	示例值	描述
ret_code	Number	0	状态码
ret_msg	String	success	描述

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAilabsAligenieOpenvideoPushRequest req = new AlibabaAilabsAligenieOpenvideoPushRequest();
List<AlibabaAilabsAligenieOpenvideoPushRequest.RawSingleVideo> list2 = new ArrayList<AlibabaAilabsAligenieOpenvideoPushRequest.RawSingleVideo>();
AlibabaAilabsAligenieOpenvideoPushRequest.RawSingleVideo obj3 = new AlibabaAilabsAligenieOpenvideoPushRequest.RawSingleVideo();
list2.add(obj3);
obj3.setReleaseTime(1562256939000L);
obj3.setTagIds(new Long[] { 10321 };
);
obj3.setChargeType(0L);
obj3.setAlbumId("100001");
obj3.setDescription("视频介绍");
obj3.setLanguage("英语");
obj3.setLikeCount(3000L);
obj3.setActorName("刘德华");
obj3.setTitle("视频标题");
obj3.setPlayUrl("{\"1080P\":\"http://abc.mp4\"}");
obj3.setDuration(500L);
obj3.setIsExclusive(0L);
obj3.setSubTitle("子标题");
obj3.setValidEndTime(1562256939000L);
obj3.setDirectorName("张艺谋");
obj3.setAlias("别名1");
obj3.setId("10001");
obj3.setForwardCount(3000L);
obj3.setArea("中国");
obj3.setVCoverUrl("http://c.jpg");
obj3.setCommonCateId(80021002L);
obj3.setValidStartTime(1562256939000L);
obj3.setSupportDefinition("480P");
obj3.setProducerName("出品人");
obj3.setCollectCount(3000L);
obj3.setExtendInfo("{\"a\":1}");
obj3.setOupgcType("PGC");
obj3.setCommentCount(3000L);
obj3.setCoverUrl("http://d.jpg");
obj3.setPlayCount(3000L);
obj3.setUploaderName("上传者");
obj3.setOrderIndex(100L);
obj3.setContentScore(10L);
obj3.setOperation("ADD");
obj3.setSuggestMaxPrice(1200L);
obj3.setSuggestMinPrice(1200L);
obj3.setCostPrice(1000L);
obj3.setAuditionSecond(180L);
req.setVideos(list2);
AlibabaAilabsAligenieOpenvideoPushResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAilabsAligenieOpenvideoPushRequest req = new AlibabaAilabsAligenieOpenvideoPushRequest();
List<AlibabaAilabsAligenieOpenvideoPushRequest.RawSingleVideoDomain> list2 = new List<AlibabaAilabsAligenieOpenvideoPushRequest.RawSingleVideoDomain>();
AlibabaAilabsAligenieOpenvideoPushRequest.RawSingleVideoDomain obj3 = new AlibabaAilabsAligenieOpenvideoPushRequest.RawSingleVideoDomain();
list2.Add(obj3);
obj3.ReleaseTime = 1562256939000L;
obj3.TagIds = new long[] { 10321 };
;
obj3.ChargeType = 0L;
obj3.AlbumId = "100001";
obj3.Description = "视频介绍";
obj3.Language = "英语";
obj3.LikeCount = 3000L;
obj3.ActorName = "刘德华";
obj3.Title = "视频标题";
obj3.PlayUrl = "{\"1080P\":\"http://abc.mp4\"}";
obj3.Duration = 500L;
obj3.IsExclusive = 0L;
obj3.SubTitle = "子标题";
obj3.ValidEndTime = 1562256939000L;
obj3.DirectorName = "张艺谋";
obj3.Alias = "别名1";
obj3.Id = "10001";
obj3.ForwardCount = 3000L;
obj3.Area = "中国";
obj3.VCoverUrl = "http://c.jpg";
obj3.CommonCateId = 80021002L;
obj3.ValidStartTime = 1562256939000L;
obj3.SupportDefinition = "480P";
obj3.ProducerName = "出品人";
obj3.CollectCount = 3000L;
obj3.ExtendInfo = "{\"a\":1}";
obj3.OupgcType = "PGC";
obj3.CommentCount = 3000L;
obj3.CoverUrl = "http://d.jpg";
obj3.PlayCount = 3000L;
obj3.UploaderName = "上传者";
obj3.OrderIndex = 100L;
obj3.ContentScore = 10L;
obj3.Operation = "ADD";
obj3.SuggestMaxPrice = 1200L;
obj3.SuggestMinPrice = 1200L;
obj3.CostPrice = 1000L;
obj3.AuditionSecond = 180L;
req.Videos_ = list2;
AlibabaAilabsAligenieOpenvideoPushResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAilabsAligenieOpenvideoPushRequest;
$videos = new RawSingleVideo;
$videos->release_time="1562256939000";
$videos->tag_ids="10321";
$videos->charge_type="0";
$videos->album_id="100001";
$videos->description="视频介绍";
$videos->language="英语";
$videos->like_count="3000";
$videos->actor_name="刘德华";
$videos->title="视频标题";
$videos->play_url="{\"1080P\":\"http://abc.mp4\"}";
$videos->duration="500";
$videos->is_exclusive="0";
$videos->sub_title="子标题";
$videos->valid_end_time="1562256939000";
$videos->director_name="张艺谋";
$videos->alias="别名1";
$videos->id="10001";
$videos->forward_count="3000";
$videos->area="中国";
$videos->v_cover_url="http://c.jpg";
$videos->common_cate_id="80021002";
$videos->valid_start_time="1562256939000";
$videos->support_definition="480P";
$videos->producer_name="出品人";
$videos->collect_count="3000";
$videos->extend_info="{\"a\":1}";
$videos->oupgc_type="PGC";
$videos->comment_count="3000";
$videos->cover_url="http://d.jpg";
$videos->play_count="3000";
$videos->uploader_name="上传者";
$videos->order_index="100";
$videos->content_score="10";
$videos->operation="ADD";
$videos->suggest_max_price="1200";
$videos->suggest_min_price="1200";
$videos->cost_price="1000";
$videos->audition_second="180";
$req->setVideos(json_encode($videos));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.ailabs.aligenie.openvideo.push' \
-d 'partner_id=apidoc' \
-d 'sign=61E06189A1E7205F403F4B972A29F81F' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+01%3A45%3A51' \
-d 'v=2.0' \
-d 'videos=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaAilabsAligenieOpenvideoPushRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.videos=""
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.ailabs.aligenie.openvideo.push");
add_param(pRequest,"videos","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.ailabs.aligenie.openvideo.push', {
	'videos':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_ailabs_aligenie_openvideo_push_response>
    <ret_code>0</ret_code>
    <ret_msg>success</ret_msg>
</alibaba_ailabs_aligenie_openvideo_push_response>

{
    "alibaba_ailabs_aligenie_openvideo_push_response":{
        "ret_code":0,
        "ret_msg":"success"
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

天猫精灵开放API

alibaba.ailabs.aligenie.openvideo.push (天猫精灵内容库视频分集数据推送接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈