UploadStreamByURL - 媒体流URL拉取上传

调用UploadStreamByURL基于源文件URL,拉取媒体流文件进行上传。

接口说明

该接口用于URL拉取上传媒体流,上传完成之后将该媒体流挂载到指定MediaId下。

调试

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

调试

授权信息

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

请求参数

名称类型必填描述示例值
StreamURLstring

转码流文件URL。

如果转码流的URL需要鉴权,需要在StreamURL中传入鉴权参数,并确保该URL可以通过公网访问。

https://example.com/sample-stream.mp4
MediaIdstring

媒资ID。

411bed50018971edb60b0764a0ec6***
Definitionstring

视频流清晰度定义。取值:

  • FD:流畅。
  • LD:标清。
  • SD:高清。
  • HD:超清
  • OD:原画。
  • 2K:2K。
  • 4K:4K。
  • SQ:普通音质。
  • HQ:高音质。
HD
FileExtensionstring

媒体文件扩展名。

mp4
HDRTypestring

转码流HDR类型。取值:

  • HDR
  • HDR10
  • HLG
  • DolbyVision
  • HDRVivid
  • SDR+
说明
  • 大小写不敏感。
  • 非HDR视频该参数为空即可。
  • HDR10
    UserDatastring

    用户自定义参数。

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

    返回参数

    名称类型描述示例值
    object

    返回结果。

    RequestIdstring

    请求ID。

    ******89-C21D-4B78-AE24-3788B8******
    JobIdstring

    上传任务ID。

    ****cdb3e74639973036bc84****
    MediaIdstring

    媒资ID。

    411bed50018971edb60b0764a0ec6***
    FileURLstring

    文件OSS地址。

    http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4
    SourceURLstring

    上传任务对应的源文件URL。

    https://example.com/sample-stream.mp4

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "******89-C21D-4B78-AE24-3788B8******",
      "JobId": "****cdb3e74639973036bc84****",
      "MediaId": "411bed50018971edb60b0764a0ec6***",
      "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4",
      "SourceURL": "https://example.com/sample-stream.mp4"
    }

    错误码

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

    阿里云首页 智能媒体生产 相关技术圈