调用CreateUploadImage获取图片上传地址和凭证。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateUploadImage

系统规定参数。取值:CreateUploadImage

ImageType String default

图片类型。取值:

  • default(默认)
  • cover(封面)
说明 控制台暂时仅支持default类型的图片管理。
Title String mytitle

图片标题。规则:

  • 长度不超过128个字节。
  • UTF-8编码。
ImageExt String png

图片文件扩展名。取值:

  • png(默认)
  • jpg
  • jpeg
  • gif
Tags String 测试

图片标签。规则:

  • 单个标签不超过32字节。最多不超过16个标签。
  • 多个标签,请使用英文逗号(,)分隔。
  • UTF-8编码。
StorageLocation String outin-****..oss-cn-shanghai.aliyuncs.com

存储地址。

当地址不为空时,会使用该指定的存储地址上传视频文件。登录点播控制台,选择配置管理 > 媒资管理配置 > 存储管理查看存储地址。

CateId Long 12001111

分类ID。

登录点播控制台,选择配置管理 > 媒资管理配置 > 分类管理编辑或查看分类的ID。

UserData String {"MessageCallback":{"CallbackURL":"http://test.test.com"},"Extend":{"localId":"xxx","test":"www"}}

自定义设置,为JSON字符串,支持消息回调、上传加速(使用前请您提交工单给后台帮您开通)等设置。详情参见UserData

说明 此参数中消息回调的使用前提是需要在控制台配置HTTP回调地址和勾选对应的回调事件类型才能使用,否则回调设置不生效。
Description String 图片上传测试

图片描述。

  • 长度不超过1024个字节。
  • UTF-8编码。
AppId String app-****

应用ID。默认取值:app-1000000。更多详情,请参见多应用

返回数据

名称 类型 示例值 描述
FileURL String http://aliyun.com/cover/2017-*****B-4F4C-9373-003AA06012EA.png

文件OSS地址(不带鉴权)。添加水印时该地址可做添加水印接口的入参FileUrl。

ImageId String 93ab850b4f6f4*****6e91d24d81d4

图片ID。

ImageURL String http://aliyun.com/cover/2017-*****B-4F4C-9373-003AA06012EA.png

图片地址。

RequestId String 25818875-5F78*****EF6-D7393642CA58

请求ID。

UploadAddress String eyJTZWN1cm*****uIjoiQ0FJU3p3TjF

上传地址。

UploadAuth String eyJFbmR*****CI6Im

上传凭证。

说明
  • 该接口不会真正上传图片文件,您需在获得上传凭证和地址后,对其进行Base64解码,再调用OSS SDK将图片文件上传至指定的bucket中(和视频上传相同)。
  • 图片水印通过获取辅助媒资上传地址和凭证接口上传。
  • 如果图片上传凭证失效( 有效期3000秒),请重新调用此接口获取上传地址和凭证。
  • 如果返回的ImageURL在浏览器无法访问(403),是因为您开启了点播域名的鉴权功能。可关闭URL鉴权或自助生成鉴权签名
  • 更多使用说明,请参见上传地址和凭证

示例

请求示例

https://vod.aliyuncs.com/?Action=CreateUploadImage
&ImageType=default
&<公共请求参数>

正常返回示例

XML 格式

<CreateUploadImageResponse>
      <RequestId>25818875-5F78*****EF6-D7393642CA58</RequestId>
      <ImageId>93ab850b4f6f4*****6e91d24d81d4</ImageId>
      <UploadAddress>eyJTZWN1cm*****uIjoiQ0FJU3p3TjF</UploadAddress>
      <UploadAuth>eyJFbmR*****CI6Im</UploadAuth>
      <ImageURL>http://aliyun.com/cover/2017-*****B-4F4C-9373-003AA06012EA.png</ImageURL>
      <FileURL>http://aliyun.com/cover/2017-*****B-4F4C-9373-003AA06012EA.png</FileURL>
</CreateUploadImageResponse>

JSON 格式

{
    "CreateUploadImageResponse": {
        "RequestId": "25818875-5F78*****EF6-D7393642CA58",
        "ImageId": "93ab850b4f6f4*****6e91d24d81d4",
        "UploadAddress": "eyJTZWN1cm*****uIjoiQ0FJU3p3TjF",
        "UploadAuth": "eyJFbmR*****CI6Im",
        "ImageURL": "http://aliyun.com/cover/2017-*****B-4F4C-9373-003AA06012EA.png",
        "FileURL":"http://aliyun.com/cover/2017-*****B-4F4C-9373-003AA06012EA.png"
    }
}

错误码

访问错误中心查看更多错误码。

SDK示例

建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见: