You need to enable JavaScript to run this app.
导航

确认上传并上报上传结果

最近更新时间2024.01.31 15:19:58

首次发布时间2021.02.23 10:42:24

本接口用于确认文件上传到 veImageX 的结果。确认文件上传成功,并向您返回上传结果。具体上传流程请参考服务端上传

说明

强烈不建议您依赖本接口返回的图片 meta 信息,有获取 meta 需求推荐在上传完成后拼接~info模板获取图片 meta 信息。原因请见为什么不建议依赖 Commit 阶段返回的图片 meta 信息?

注意事项

  • 请求频率:单业务(服务 ID)请求频率限制为 100 次/秒

  • 超时时间:超时时间为 5 秒

请求说明

  • 请求方式:POST

  • 接口地址:https://imagex.volcengineapi.com/?Action=CommitImageUpload&Version=2018-08-01

说明

veImageX 在全球多个区域部署,每个区域有自己对应的 OpenAPI 域名,不支持跨区域调用。具体详情请查看服务地址

请求参数

以下请求参数列表仅列出了该接口的部分公共参数,完整公共参数列表见公共参数

Query

参数类型是否必选示例值描述
ActionStringCommitImageUpload接口名称。CommitImageUpload
VersionString2018-08-01接口版本

ServiceId

String

kjh***9h

服务 ID。

  • 您可以在 veImageX 控制台 服务管理页面,在创建好的图片服务中获取服务 ID。

  • 您也可以通过 OpenAPI 的方式获取服务 ID,具体请参考获取所有服务信息

SkipMeta

Bool

true

是否返回图片 meta 信息。

  • true:不返回图片 meta 信息。

  • false:(默认)获取图片 meta 信息并返回对应 meta 信息。

说明

  • 其中若 meta 获取超时或失败,接口返回成功,但对应 meta 信息将为空。

  • 如果您的业务要求必须获取 meta 信息,请您参考图片Meta信息获取。

Body

参数类型是否必选示例值描述

SessionKey

String

8h***98

一次上传会话 Key。您可参考获取文件上传地址获取。

SuccessOidsArray of String101629**510102上传成功的资源 ID。

返回参数

参数类型示例值描述
ResultsArray of Result1运行结果,数组长度对应上传的数量。
RequestIdString202307031500195F***DCD5E1请求的唯一标识 ID。
PluginResultStringJSON 序列化之后的图片信息,结构体请参考 ImageInfo 的 Array。

Result

参数类型示例值描述

Uri

String

tos-cn-i-5s**fo/f2**9a.png

源文件的 Uri。

UriStatus

Integer

2000

仅当指定 SuccessOids 时才会有返回值。
上传结果。

  • 返回值为 2000,表示上传成功;
  • 返回值为 2001,表示上传失败。

ImageInfo

参数类型示例值描述
FileNameStringf2**9a.png存储文件名
SourceUriStringtos-cn-i-5sfo/f29a.png源文件 URI
ImageUriStringtos-cn-i-5sfo/f219a.png源文件 URI
ImageWidthInteger2718图片的宽
ImageHeightInteger1300图片的高
ImageMd5String9683图片的 MD5 值
ImageFormatStringpng图片格式
ImageSizeInteger108886图片大小
FrameCntInteger1图片帧数

Duration

Integer

3500

图片时长,单位为 ms。仅当图片为动图时有值

示例

请求示例

POST https://imagex.volcengineapi.com/?Action=CommitImageUpload&Version=2018-08-01&ServiceId=WM**e8&SkipMeta=true 
{
   "SessionKey":"eyJ***==",
}

返回示例

{
   "ResponseMetadata":{
      "RequestId":"202307031500195F01AEFDB6AC1CDCD5E1",
      "Action":"CommitImageUpload",
      "Version":"2018-08-01",
      "Service":"imagex",
      "Region":"cn-north-1"
   },
   "Result":{
      "Results":[
         {
            "Uri":"tos-cn-i-5sfo/f29a.png",
            "UriStatus":2000
         }
      ],
      "RequestId":"202307031500195F01AEFDB6AC1CDCD5E1",
      "PluginResult":[
         {
            "FileName":"f2**9a.png",
            "SourceUri":"tos-cn-i-5sfo/f29a.png",
            "ImageUri":"tos-cn-i-5sfo/f219a.png",
            "ImageWidth":2718,
            "ImageHeight":2300,
            "ImageMd5":"9683",
            "ImageFormat":"png",
            "ImageSize":108886,
            "FrameCnt":1
         }
      ]
   }
}

错误码

访问公共错误码获取详细信息。

服务端 SDK

为了方便您快速开发,veImageX 提供了配套的服务端 SDK,同时支持多种编程语言。建议您使用服务端 SDK 来调用 API,参考文档如下所示: