淘宝开放平台

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
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。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
item	Item	可选			商品
itemImages ItemImages [] 可选商品主图片 └ id String 可选 11 图片id └ position String 可选 1 图片位次 └ url String 可选 https://img.alicdn.com/bao/uploaded/i1/2222228/O1CN04vjYL1IQkZNs3XbG_!!2222228.jpg 图片url material Material 可选素材-商品主视频 └ outerPartId String 可选 FI001 外部id textList TextList [] 可选花字时序 └ time String 可选 1~4S 时间 └ text String 可选真好看花字 └ contentId String 可选 10 商品视频id └ description String 可选这是一个女装导购视频商品视频描述 └ aspectRatio String 可选 1:1 商品视频比例 └ type String 可选 video 商品视频类型 └ title String 可选测试视频商品视频标题 └ uploadTime String 可选 2023-01-20 00:00:00 商品视频时间 └ playUrl String 可选 http://tbm-auth.alicdn.com/b9d4689bbf537b68/u8yp5or.mp4 商品视频url └ coverUrl String 可选 https://img.alicdn.com/imgextra/i2/O1CN01j61pd3292AnxSZXyS_!!6000000008009-2-tps-64-64.png 商品视频封面url └ duration String 可选 20 商品视频持续时间 └ width String 可选 480 商品视频宽 └ text String 可选这是一个很好看的花瓶商品视频文本 └ height String 可选 480 商品视频高 └ industry String 可选零食行业 └ title String 可选黑特等巧克力321 标题 └ type String 可选香甜, 脆弹, 性价比高类型
proportion	String	可选	16:9,1:1		比例
materialList	MaterialList []	可选		最大列表长度：999999	素材列表
└ outerPartId String 可选 FI001 外部片段id textList TextList [] 可选花字列表 └ time String 可选 1~4S 时间 └ text String 可选真好看花字 └ contentId String 可选 10 商品视频id └ description String 可选这是一个女装导购视频商品视频描述 └ aspectRatio String 可选 1:1 商品视频比例 └ type String 可选 video 商品视频类型 └ title String 可选测试视频商品视频标题 └ uploadTime String 可选 2023-01-20 00:00:00 商品视频时间 └ playUrl String 可选 http://tbm-auth.alicdn.com/b9d4689bbf537b68/u8yp5or.mp4 商品视频url └ coverUrl String 可选 https://img.alicdn.com/imgextra/i2/O1CN01j61pd3292AnxSZXyS_!!6000000008009-2-tps-64-64.png 商品视频封面url └ duration String 可选 20 商品视频持续时间 └ width String 可选 480 宽 └ text String 可选这是一个很好看的花瓶文本 └ height String 可选 480 高
length	String	可选	30,15		长度
bgm	String	可选	2		bgm
autoClear	String	可选	2		自动清理
say	String	可选	2		口播
templateId	String	可选	234234		模板id
gmtCreate	String	可选	2022-12-12 00:00:00		创建时间
fenbianlv	String	可选	16:9		分辨率
autoGreater	String	可选	2		自动生成
style	String	可选	幽默,风趣,理性分析		风格
id	String	可选	234234		id
word	String	可选	2		文案

名称	类型	示例值	描述
result	Result		结果
partBaseList PartBaseList [] 片段列表 └ outerPartId String FI001 外部片段id textList TextList [] 花字列表 └ time String 1~4S 花字时间 └ text String 真好看花字 └ text String 这是一个很好看的花瓶口播文案 └ proportion String 16:9 比例 └ fenbianlv String 16:9 分辨率 └ part String 3 段数 └ videoInfo String 家具爆款视频, 行业爆款说明 └ videoTags String [] 表亲 └ length String 15 长度 └ fileId String 017f-3eaa3638-a1b2398a-7f20d281-5037 文件id
success	String	true	success
errorCode1	String	isv.xxx	code
errorMsg1	String	授权异常	msg

{"item":{"itemImages":[{"id":"11","position":"1","url":"https://img.alicdn.com/bao/uploaded/i1/2222228/O1CN04vjYL1IQkZNs3XbG_!!2222228.jpg"}],"material":{"outerPartId":"FI001","textList":[{"time":"1~4S","text":"真好看"}],"contentId":"10","description":"这是一个女装导购视频","aspectRatio":"1:1","type":"video","title":"测试视频","uploadTime":"2023-01-20 00:00:00","playUrl":"http://tbm-auth.alicdn.com/b9d4689bbf537b68/u8yp5or.mp4","coverUrl":"https://img.alicdn.com/imgextra/i2/O1CN01j61pd3292AnxSZXyS_!!6000000008009-2-tps-64-64.png","duration":"20","width":"480","text":"这是一个很好看的花瓶","height":"480"},"industry":"零食","title":"黑特等巧克力321","type":"香甜, 脆弹, 性价比高"},"proportion":"16:9,1:1","materialList":[{"outerPartId":"FI001","textList":[{"time":"1~4S","text":"真好看"}],"contentId":"10","description":"这是一个女装导购视频","aspectRatio":"1:1","type":"video","title":"测试视频","uploadTime":"2023-01-20 00:00:00","playUrl":"http://tbm-auth.alicdn.com/b9d4689bbf537b68/u8yp5or.mp4","coverUrl":"https://img.alicdn.com/imgextra/i2/O1CN01j61pd3292AnxSZXyS_!!6000000008009-2-tps-64-64.png","duration":"20","width":"480","text":"这是一个很好看的花瓶","height":"480"}],"length":"30,15","bgm":"2","autoClear":"2","say":"2","templateId":"234234","gmtCreate":"2022-12-12 00:00:00","fenbianlv":"16:9","autoGreater":"2","style":"幽默,风趣,理性分析","id":"234234","word":"2"}

{
    "result":{
        "partBaseList":[
            {
                    "outerPartId":"FI001",
                    "textList":[
                        {
                                "time":"1~4S",
                                "text":"真好看"
                        }
                    ],
                    "text":"这是一个很好看的花瓶"
            }
        ],
        "proportion":"16:9",
        "fenbianlv":"16:9",
        "part":"3",
        "videoInfo":"家具爆款视频, 行业爆款",
        "length":"15",
        "fileId":"017f-3eaa3638-a1b2398a-7f20d281-5037"
    },
    "success":"true",
    "errorCode1":"isv.xxx",
    "errorMsg1":"授权异常"
}

{"result":{"errorCode1":"sign-check-failure","success":"false","errorMsg1":"Illegal request"}}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

淘宝交易API

qimen.taobao.chengfei.qimen.test.get (奇门测试chengfei)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ