Appearance
Upload - 图片上传接口
通过此接口上传图片,将本地图片转换为 Base64 后提交,成功后返回图片公网地址。
一、接口信息
| 项目 | 内容 |
|---|---|
| 请求方式 | POST |
| 请求路径 | /mj/submit/upload-discord-images |
| 完整地址 | https://api.hllapi.vip/mj/submit/upload-discord-images |
| Content-Type | application/json |
| 鉴权方式 | Bearer Token |
二、请求头
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
三、请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| base64Array | Array | 是 | 图片 Base64 字符串数组 |
已验证:单张 PNG 图片以 Base64 字符串放入数组,可以成功上传。
四、PowerShell 请求示例
先将图片放在本地,例如 C:\Users\Nee\Desktop\test.jpg。
$imagePath = "C:\Users\Nee\Desktop\test.jpg"
$base64 = [Convert]::ToBase64String(
[IO.File]::ReadAllBytes($imagePath)
)
$body = @{
base64Array = @($base64)
} | ConvertTo-Json -Depth 5
Invoke-RestMethod `
-Uri "https://api.hllapi.vip/mj/submit/upload-discord-images" `
-Method POST `
-Headers $headers `
-ContentType "application/json" `
-Body $body
其中 $headers 应预先设置 Authorization: Bearer YOUR_API_KEY。
五、JSON 请求结构
{
"base64Array": [
"BASE64_IMAGE_DATA"
]
}
六、成功响应
已验证的响应结构:
{
"code": 1,
"description": "提交成功",
"result": [
"https://example.com/uploaded-image.png"
]
}
result 中的图片地址以接口实际返回为准。
七、错误处理
| 返回信息 | 说明 |
|---|---|
| code: 1 | 图片上传成功 |
| base64 参数错误 | 图片 Base64 参数不符合要求 |
八、注意事项
- base64Array 不能为空。
- 请传入有效的图片 Base64 数据。
- 本次已验证单张 PNG 图片上传。
- 多图片上传数量限制、文件大小限制及其他格式支持情况尚未核实。