图床V2 API 文档

接口说明

图床V2 API 是一个将用户上传的静态图片实现理论永久存储的接口。用户上传图片后，系统自动完成中转处理，最终返回永久有效的图片链接。支持跨域访问，需要密钥验证。

本接口适用于需要将图片托管到云端并获取稳定访问链接的场景，如博客配图、网站素材、社交媒体分享等。上传成功后返回的图片链接理论上永久有效，可放心引用。

调用地址

https://api.xunjinlu.fun/api/tc/v2.php

请求方式

POST

鉴权方式

本接口支持以下鉴权方式：

• Query 参数：在 URL 查询字符串中传递密钥

请求参数

参数说明

key

接口访问密钥，用于验证调用者身份。需在请求 URL 的 Query 字符串中传递。密钥可在开发者平台申请获取。

image

要上传的图片文件，仅支持静态图片格式（如 JPG、PNG、GIF、WebP 等）。通过表单文件上传方式提交，字段名为 image。

请求示例

cURL 示例

curl -X POST "https://api.xunjinlu.fun/api/tc/v2.php?key=sk_xxxxxxxxxxxxxxxx" \
  -F "image=@/path/to/example.jpg"

PHP 示例

// 图床V2 图片上传示例

$url = "https://api.xunjinlu.fun/api/tc/v2.php?key=sk_xxxxxxxxxxxxxxxx";
$imagePath = "/path/to/example.jpg";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'image' => new CURLFile($imagePath)
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

$result = json_decode($response, true);
if ($result['code'] === 200) {
    echo "上传成功，图片链接：" . $result['data']['url'];
} else {
    echo "上传失败：" . $result['msg'];
}

Python 示例

import requests

url = "https://api.xunjinlu.fun/api/tc/v2.php"
params = {"key": "sk_xxxxxxxxxxxxxxxx"}
files = {"image": open("/path/to/example.jpg", "rb")}

response = requests.post(url, params=params, files=files)
result = response.json()

if result["code"] == 200:
    print("上传成功，图片链接：", result["data"]["url"])
else:
    print("上传失败：", result["msg"])

JavaScript 示例

const formData = new FormData();
formData.append("image", fileInput.files[0]);

fetch("https://api.xunjinlu.fun/api/tc/v2.php?key=sk_xxxxxxxxxxxxxxxx", {
    method: "POST",
    body: formData
})
.then(response => response.json())
.then(result => {
    if (result.code === 200) {
        console.log("上传成功，图片链接：", result.data.url);
    } else {
        console.error("上传失败：", result.msg);
    }
});

成功响应示例

{
    "code": 200,
    "msg": "上传成功",
    "data": {
        "url": "http://luobr.oss-cn-shanghai.aliyuncs.com/17784975435810.jpg"
    },
    "api_info": {
        "developer": "尋鯨錄",
        "blog": "https://www.xunjinlu.fun",
        "api_platform": "https://api.xunjinlu.fun"
    }
}

错误响应示例

未提供密钥

{
    "code": 0,
    "msg": "未提供密钥",
    "errcode": 11001
}

密钥错误

{
    "code": 0,
    "msg": "密钥错误",
    "errcode": 11002
}

密钥已禁用

{
    "code": 0,
    "msg": "密钥已禁用",
    "errcode": 11003
}

积分不足

{
    "code": 0,
    "msg": "积分不足",
    "errcode": 11004
}

请求过于频繁

{
    "code": 0,
    "msg": "请求过于频繁",
    "errcode": 11005
}

维护中

{
    "code": 0,
    "msg": "维护中",
    "errcode": 11006
}

接口已禁用

{
    "code": 0,
    "msg": "接口已禁用",
    "errcode": 11007
}

鉴权方式错误

{
    "code": 0,
    "msg": "鉴权方式错误",
    "errcode": 11012
}

响应字段说明

顶层字段

data 字段

api_info 字段

业务错误码

频率限制

本接口频率限制为：每分钟约 60 次。

超过频率限制时，接口将返回 errcode: 11005 错误。请合理控制请求频率，避免触发限流。

计费说明

本接口为免费接口，无需积分即可调用。但仍需进行密钥鉴权。

分类

图片工具

注意事项

1. 本接口仅支持静态图片上传，不支持动态图片或其他文件格式。
2. 上传的图片将进行中转处理，最终返回永久有效的图片链接。
3. 返回的图片链接支持跨域访问，可直接在网页中引用。
4. 请妥善保管您的密钥，避免泄露。如发现密钥泄露，请及时更换。
5. 如遇到 errcode: 11005 错误，请降低请求频率后重试。
6. 接口返回的图片链接理论上永久有效，但建议自行做好备份以防万一。