全部产品
Search

搜索本产品

    媒体处理：UpdateMedia - 更新媒体基本信息

    文档中心

    媒体处理：UpdateMedia - 更新媒体基本信息

    更新时间：Nov 11, 2024

    更新媒体基本信息。

    接口说明

    本接口更新的媒体基本信息包括标题、描述、类目等。注意是全量更新，每个属性都要设置，未设置的会被空值覆盖。

    QPS 限制

    本接口的单用户 QPS 限制为 100 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

    调试

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

    授权信息

    当前API暂无授权信息透出。

    请求参数

    名称类型必填描述示例值
    MediaIdstring是

    需要更新基本信息的媒体 ID。可以通过 MPS 控制台 > 媒体管理 > 媒体列表获取。

    		3e1cd21131a94525be55acf65888****
    Titlestring否

    媒体标题。支持中英文、数字等。

    • 若不设置则清空此字段。
    • UTF8 编码，最大 128 字节。
    		hello
    Descriptionstring否

    媒体描述。支持中英文、数字等。

    • 若不设置则清空此字段。
    • UTF8 编码，最大 1024 字节。
    		example description
    CoverURLstring否

    封面 URL。即您需要设置的封面的存储地址，可以通过 MPS 控制台 > 工作流管理 > 媒体 Bucket或OSS 控制台 > 我的访问路径获取。

    • 不超过 3200 字节。
    • URL 遵循 RFC 2396（UTF-8 编码，并进行 URLEncode）。更多信息，请参见 URLEncode 说明。
    		http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test****.jpg
    CateIdlong否

    类目 ID，整数。

    • 若不设置则清空此字段。
    • 不能为负数。
    		1
    Tagsstring否

    标签列表。

    • 用半角逗号（,）分隔，不超过 16 个标签。
    • 单个标签不超过 32 字节。
    • UTF8 编码。
    		tag1,tag2

    返回参数

    名称类型描述示例值
    object

    返回参数。

    RequestIdstring

    请求 ID。

    		6A88246F-C91F-42BD-BABE-DB0DF993F960
    Mediaobject

    媒体信息。

    CreationTimestring

    创建时间。

    		2016-09-14T08:30:33Z
    CateIdlong

    类目 ID。

    		1
    Heightstring

    媒体文件高。

    		1080
    CensorStatestring

    视频审核状态。取值：

    • Initiated：初始（上传成功审核未完成）。

    • Pass：通过（上传成功审核已通过）。

    		Initiated
    Tagsarray

    标签信息。

    Tagstring

    标签列表。

    		tag1,tag2
    Bitratestring

    码率。

    		2659.326
    MediaIdstring

    媒体 ID。

    		3e1cd21131a94525be55acf65888****
    Fileobject

    原文件。

    Statestring

    文件状态。取值范围：

    • Normal：正常。

    • Deleted：已删除。

    		Normal
    URLstring

    输入文件的 OSS Bucket。

    		http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4
    PublishStatestring

    媒体发布状态，表示是否对外发布媒体。取值：

    • Initiated：初始。
    • UnPublish：未发布，OSS 播放文件权限为 Private。
    • Published：已发布，OSS 播放文件权限为 Default。
    • Deleted：已删除。
    		Published
    Descriptionstring

    媒体文件描述。

    		example description
    Widthstring

    媒体文件宽。

    		1920
    Sizestring

    媒体文件大小。

    		2647692
    CoverURLstring

    封面 URL。

    		http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg
    RunIdListarray

    媒体工作流执行实例 ID 列表。

    RunIdstring

    媒体工作流执行实例 ID 列表。

    		{"RunId":["47b42486019c4f688bf144c1a6ba****"]}
    Durationstring

    时长。

    		7.965000
    Fpsstring

    帧率。

    		25.0
    Titlestring

    标题。

    		hello
    Formatstring

    格式。支持 mov，mp4，m4a，3gp，3g2，mj2。

    		mov

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "6A88246F-C91F-42BD-BABE-DB0DF993F960",
  "Media": {
    "CreationTime": "2016-09-14T08:30:33Z",
    "CateId": 1,
    "Height": "1080",
    "CensorState": "Initiated",
    "Tags": {
      "Tag": [
        "tag1,tag2"
      ]
    },
    "Bitrate": "2659.326",
    "MediaId": "3e1cd21131a94525be55acf65888****",
    "File": {
      "State": "Normal",
      "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "PublishState": "Published",
    "Description": "example description",
    "Width": "1920",
    "Size": "2647692",
    "CoverURL": "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg",
    "RunIdList": {
      "RunId": [
        "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}"
      ]
    },
    "Duration": "7.965000",
    "Fps": "25.0",
    "Title": "hello",
    "Format": "mov"
  }
}

    错误码

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史