图像

通过Base64编码上传图片

0次调用

2 积分/次

当你需要在前端处理完图片（比如裁剪、加滤镜后），不通过传统表单，而是直接上传图片的场景，这个接口就派上用场了。

接口调整中

该接口因政策原因已下架，短期内不会恢复。后续是否恢复及恢复时间将另行通知。

POST

uapis.cn

/api/v1/image/frombase64

Body

imageData

string

required

图片的Base64 Data URI，必须包含MIME类型头。例如：data:image/png;base64,...

功能概述

你只需要将图片的 Base64 编码字符串发送过来，我们就会把它解码、保存为图片文件，并返回一个可供访问的公开 URL。

使用须知

重要

关于 imageData 格式 你发送的 imageData 字符串必须是完整的 Base64 Data URI 格式，它需要包含 MIME 类型信息，例如 data:image/png;base64,iVBORw0KGgo...。缺少 data:image/...;base64, 前缀将导致解码失败。

请求体

imageData

string必填

图片的Base64 Data URI，必须包含MIME类型头。例如：data:image/png;base64,...

名称	类型	属性	说明
`imageData`	string	必填	图片的Base64 Data URI，必须包含MIME类型头。例如：`data:image/png;base64,...`

响应

200 / 请求成功

上传成功！返回图片的访问地址。

JSON

{
  // 图片保存后在服务器上的绝对访问URL。
  "image_url": "https://uapis.cn/static/uploads/91e42db1c66c0b276abf6234dc50b2eb.png",
  // 操作结果描述。
  "msg": "success"
}

400 / 错误的请求

请求失败。可能的原因有：请求体不是有效的JSON，缺少 imageData 字段，或者 imageData 的内容不是有效的Base64 Data URI。

JSON

{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Invalid request body or imageData."
}

500 / 服务器内部错误

服务器内部错误。在解码或保存图片文件时发生了未知错误。请稍后重试。

JSON

{
  "code": "INTERNAL_SERVER_ERROR",
  "details": {},
  "message": "Failed to save the image."
}

快速上手

选择你的语言查看调用示例

认证方式：

cURL 命令

curl -X POST 'https://uapis.cn/api/v1/image/frombase64' \
  -H 'Content-Type: application/json' \
  -d '{"imageData": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII="}'

常见问题解答