图床上传接口说明

基于 Lsky 的图片上传接口说明及在线调试工具。

接口基本信息

POST https://img.sicxs.cn/api/v1/upload
Header 字段 值 是否必须 说明
Accept application/json 是 必须设置为 application/json
Content-Type multipart/form-data 是 表单传输格式
Authorization Bearer {your_token} 否 未携带 Token 时将以游客身份上传（如管理员未开放游客权限，则会报错 403/500）

请求参数 (Body)

参数名称 类型 是否必须 说明
file File 是 要上传的图片文件。支持 jpg, jpeg, png, gif, webp 等格式。
strategy_id Integer 否 存储策略 ID（默认值：1）
album_id Integer 否 相册 ID
permission Integer 否 权限：1=公开，0=私有（默认值：1）

多语言调用示例

cURL
PHP
JS (Fetch)
Python
curl -X POST https://img.sicxs.cn/api/v1/upload \
  -H "Accept: application/json" \
  -H "Authorization: Bearer ***|your_token_here" \
  -F "file=@/path/to/your/image.jpg" \
  -F "strategy_id=1"
<?php
$ch = curl_init('https://img.sicxs.cn/api/v1/upload');
$postData = [
    'file' => new CURLFile('/path/to/your/image.jpg', 'image/jpeg', 'image.jpg'),
    'strategy_id' => 1
];

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $postData,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer ***|your_token_here'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('strategy_id', '1');

fetch('https://img.sicxs.cn/api/v1/upload', {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer ***|your_token_here'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
import requests

url = 'https://img.sicxs.cn/api/v1/upload'
headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer ***|your_token_here'
}
files = {
    'file': ('image.jpg', open('/path/to/your/image.jpg', 'rb'), 'image/jpeg')
}
data = {
    'strategy_id': '1'
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

在线调试与上传测试

☁
点击或拖拽文件到这里上传
支持图片文件格式 (jpg, png, gif, webp)
接口返回结果 (JSON)：
{}