辅助工具 API（测试版）

功能描述：辅助工具集合，按用途分为以下几个接口，详见后续各节。

1. 广告视频响度转换

接口：assisttool/convertloud
请求字段：

名称	类型	描述
data	数组类型	最多1个

data 内容详细：

名称	类型	必填	描述
url	string	Y	视频创意 url

接口返回：

名称	类型	描述
ret_code	int	返回码
ret_msg	数组类型	返回内容
error_code	int	错误补充码

ret_msg 内容详细：

名称	类型	描述
url	string	视频创意原始 url
convert_url	string	视频创意转换后 url
error_code	int	需要时返回，成功时不返回，失败返回具体错误码
err_msg	string	需要时返回，成功时不返回，错误具体描述

请求示例：

{
  "data": [
    {
      "url": "http://cdn.dsp.com/a/b/c.mp4"
    }
  ]
}

返回示例（成功）：

{
  "ret_code": 0,
  "ret_msg": [
    {
      "url": "http://cdn.dsp.com/a/b/c.mp4",
      "convert_url": "http://adx.qq.com/dsp/file/new_c.mp4"
    }
  ]
}

返回示例（失败）：

{
  "ret_code": 1,
  "ret_msg": [
    {
      "url": "http://cdn.dsp.com/a/b/c.mp4",
      "err_code": 1135,
      "err_msg": "request concurrence limit."
    }
  ]
}

2. 广告视频 mov 转透明背景 MP4（仅适用破框视频转换场景）

提交接口：assisttool/convertmov
请求字段：

名称	类型	描述
data	数组类型	最多1个

data 内容详细：

名称	类型	必填	描述
display_id	int	Y	播放形式ID
url	string	Y	视频创意 url

注：display_id 必填

接口返回：

名称	类型	描述
ret_code	int	返回码
ret_msg	数组类型	返回内容
error_code	int	错误补充码

ret_msg 内容详细：

名称	类型	描述
url	string	视频创意原始 url
id	int	转换ID
error_code	int	需要时返回，成功时不返回，失败返回具体错误码
err_msg	string	需要时返回，成功时不返回，错误具体描述

请求示例：

{
  "data": [
    {
      "url": "http://dsptest.adx.qq.com/upload/ryt.mov"
    }
  ],
  "dsp_id": 111,
  "sig": "111",
  ...
}

返回示例：

{
  "ret_code": 0,
  "ret_msg": [
    {
      "url": "http://dsptest.adx.qq.com/images/ryt2.mov",
      "id": 100001
    }
  ],
  "error_code": 0
}

获取结果接口：assisttool/convertmovresult
请求字段：

名称	类型	描述
data	数组类型	最多1个

data 内容详细：

名称	类型	必填	描述
id	int	Y	转换ID

接口返回：

名称	类型	描述
ret_code	int	返回码
ret_msg	数组类型	返回内容
error_code	int	错误补充码

ret_msg 内容详细：

名称	类型	描述
url	string	视频创意原始 url
convert_url	string	视频创意转换后 url
id	int	转换ID
error_code	int	需要时返回，成功时不返回，失败返回具体错误码
err_msg	string	需要时返回，成功时不返回，错误具体描述

请求示例：

{
  "data": [
    {
      "id": 100001
    }
  ],
  "dsp_id": 111,
  "sig": "111",
  ...
}

返回示例：

{
  "ret_code": 0,
  "ret_msg": [
    {
      "id": 100001,
      "url": "http://dsptest.adx.qq.com/upload/ryt.mov",
      "convert_url": "https://dsptest.adx.qq.com/filefascade/getconvertfile?id=MTAwMjQyNGI1NzE3YmFmZmI4NDQwZDYzNWNjYTJhNDhjZjEzZGM=&tp=2"
    }
  ],
  "error_code": 0
}

3. 广告视频转换（通用场景，包括破框视频 mov 转 mp4 和 TV 投屏视频转换）

提交接口：assisttool/convertvideo
请求字段：

名称	类型	描述
data	数组类型	最多1个

data 内容详细：

名称	类型	必填	描述
display_id	int	Y	播放形式ID
url	string	Y	视频创意 url

注：display_id 必填 ，其中涉及投屏资源时，display_id 填写200140，获取转换后含有广告标的视频素材。

接口返回：

名称	类型	描述
ret_code	int	返回码
ret_msg	数组类型	返回内容
error_code	int	错误补充码

ret_msg 内容详细：

名称	类型	描述
url	string	视频创意原始 url
id	int	转换ID
error_code	int	需要时返回，成功时不返回，失败返回具体错误码
err_msg	string	需要时返回，成功时不返回，错误具体描述

请求示例：

{
  "data": [
    {
      "url": "http://dsptest.adx.qq.com/upload/ryt.mov"
    }
  ],
  "dsp_id": 111,
  "sig": "111",
  ...
}

返回示例：

{
  "ret_code": 0,
  "ret_msg": [
    {
      "url": "http://dsptest.adx.qq.com/images/ryt2.mov",
      "id": 100001
    }
  ],
  "error_code": 0
}

获取结果接口：assisttool/convertvideoresult
请求字段：

名称	类型	描述
data	数组类型	最多1个

data 内容详细：

名称	类型	必填	描述
id	int	Y	转换ID

接口返回：

名称	类型	描述
ret_code	int	返回码
ret_msg	数组类型	返回内容
error_code	int	错误补充码

ret_msg 内容详细：

名称	类型	描述
url	string	视频创意原始 url
convert_url	string	视频创意转换后 url
id	int	转换ID
error_code	int	需要时返回，成功时不返回，失败返回具体错误码
err_msg	string	需要时返回，成功时不返回，错误具体描述

请求示例：

{
  "data": [
    {
      "id": 100001
    }
  ],
  "dsp_id": 111,
  "sig": "111",
  ...
}

返回示例：

{
  "ret_code": 0,
  "ret_msg": [
    {
      "id": 100001,
      "url": "http://dsptest.adx.qq.com/upload/ryt.mov",
      "convert_url": "https://dsptest.adx.qq.com/filefascade/getconvertfile?id=MTAwMjQyNGI1NzE3YmFmZmI4NDQwZDYzNWNjYTJhNDhjZjEzZGM=&tp=2"
    }
  ],
  "error_code": 0
}

4. 广告图片转换（通用场景，包括获取 OTT 全屏暂停形式的默认背景图高斯模糊兜底图与默认商品图兜底图等）

提交接口：assisttool/convertimage
请求字段：

名称	类型	描述
data	数组类型	最多1个

data 内容详细：

名称	类型	必填	描述
display_id	int	Y	播放形式ID
url	string	Y	视频/图片 url

注：如果是视频广告形式则 url 传视频 url（系统默认会取首帧图片做高斯模糊处理并返回；如果是图片广告形式则 url 传原图片 url。

接口返回：

名称	类型	描述
ret_code	int	返回码
ret_msg	数组类型	返回内容
error_code	int	错误补充码

ret_msg 内容详细：

名称	类型	描述
url	string	视频创意原始 url
display_id	int	广告形式ID
blur_url	string	OTT 全屏暂停形式之经过高斯模糊处理的背景图
brand_url	string	OTT 全屏暂停形式之默认商品图
error_code	int	需要时返回，成功时不返回，失败返回具体错误码
err_msg	string	需要时返回，成功时不返回，错误具体描述

请求示例：

{
  "data": [
    {
      "url": "http://dsptest.adx.qq.com/upload/ott.mo4",
      "display_id": 200412
    }
  ],
  "dsp_id": 111,
  "sig": "111",
  ...
}

返回示例：

{
  "ret_code": 0,
  "ret_msg": [
    {
      "url": "http://dsptest.adx.qq.com/upload/ott.mo4",
      "display_id": 200412,
      "blur_url": "http://dsptest.adx.qq.com/upload/blur.jpg",
      "brand_url": "http://dsptest.adx.qq.com/upload/brand.png"
    }
  ],
  "error_code": 0
}