Skip to content

Upload - 图片上传接口 ​

通过此接口上传图片,将本地图片转换为 Base64 后提交,成功后返回图片公网地址。

一、接口信息 ​

项目内容
请求方式POST
请求路径/mj/submit/upload-discord-images
完整地址https://api.hllapi.vip/mj/submit/upload-discord-images
Content-Typeapplication/json
鉴权方式Bearer Token

二、请求头 ​

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

三、请求参数 ​

参数类型必填说明
base64ArrayArray是图片 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 参数不符合要求

八、注意事项 ​

  1. base64Array 不能为空。
  2. 请传入有效的图片 Base64 数据。
  3. 本次已验证单张 PNG 图片上传。
  4. 多图片上传数量限制、文件大小限制及其他格式支持情况尚未核实。

火灵灵 API · 开发者服务中心