爱云图床 API - 开发者首选的图片存储方案

用 API 打造高效图床

基于 Cloudflare Pages + 千牛云构建，支持批量上传、双重链接、跨域兼容，一行代码快速集成到你的项目

// 3行代码实现上传
async function uploadImage(file) {
  const formData = new FormData();
  formData.append('file', file);
  const res = await fetch('https://你的域名/api/upload', {
    method: 'POST',
    headers: {'X-API-Key': '你的密钥'},
    body: formData
  });
  return res.json(); // { proxy_url, redirect_url, ... }
}

核心优势

极速上传

Cloudflare 全球节点加速，上传下载低延迟，支持断点续传

双重链接

提供代理链接（隐藏真实地址）和重定向链接（极速加载）

跨域兼容

内置 CORS 支持，前端直接调用，无需额外配置代理服务器

免费商用

无广告、无水印，支持个人/企业商用，流量无硬性限制

3步快速对接

1

获取 API Key

在 Cloudflare Pages 后台设置环境变量 API_KEY

2

集成 API 代码

复制示例代码，替换域名和 API Key，前端直接调用

3

测试上线

上传图片测试接口稳定性，无误后正式集成到项目中

API 文档

基础信息

接口地址： https://你的域名/api/upload

请求方法： POST

数据格式： multipart/form-data

认证方式： Header 携带 API Key

请求头 (Headers)

参数名	必选	类型	说明
X-API-Key	是	String	Cloudflare 后台设置的 API_KEY
Content-Type	是	String	必须为 multipart/form-data

请求参数 (Body)

参数名	必选	类型	说明
file	是	File	要上传的图片文件（≤10MB）
channel	否	String	上传渠道，默认传 aiyun

返回结果 (JSON)

{
  "success": true,
  "channel": "aiyun_dual_mode",
  "url": "https://yourdomain.com/img/xxx.jpg",
  "proxy_url": "https://yourdomain.com/img/xxx.jpg", // 代理链接（推荐）
  "redirect_url": "https://yourdomain.com/pic/xxx.jpg", // 重定向链接
  "key": "xxx.jpg" // 唯一标识
}

错误代码说明

状态码	错误信息	说明
401	Unauthorized	API Key 错误或未提供
400	No file uploaded	未检测到上传文件
500	Internal Server Error	后端执行异常

代码示例

// 原生 JS 上传示例
async function uploadImage(file) {
  const formData = new FormData();
  formData.append('file', file);
  formData.append('channel', 'aiyun'); // 可选

  try {
    const response = await fetch('https://你的域名/api/upload', {
      method: 'POST',
      headers: {
        'X-API-Key': '你的 API_KEY'
      },
      body: formData,
      // 监听上传进度（可选）
      onUploadProgress: (e) => {
        const progress = (e.loaded / e.total) * 100;
        console.log(`上传进度：${progress.toFixed(0)}%`);
      }
    });

    const result = await response.json();
    if (result.success) {
      console.log('代理链接：', result.proxy_url);
      console.log('重定向链接：', result.redirect_url);
      return result;
    } else {
      throw new Error('上传失败：' + JSON.stringify(result));
    }
  } catch (error) {
    console.error('上传异常：', error);
    throw error;
  }
}

// 调用示例
document.querySelector('#file-input').addEventListener('change', (e) => {
  const file = e.target.files[0];
  if (file) uploadImage(file);
});

import requests

def upload_image(file_path, api_key, domain):
    url = f"https://{domain}/api/upload"
    headers = {
        "X-API-Key": api_key
    }
    files = {
        "file": open(file_path, "rb"),
        "channel": ("", "aiyun")  # 可选参数
    }

    try:
        response = requests.post(url, headers=headers, files=files)
        response.raise_for_status()  # 抛出 HTTP 错误
        result = response.json()
        if result.get("success"):
            print("代理链接：", result["proxy_url"])
            print("重定向链接：", result["redirect_url"])
            return result
        else:
            raise Exception(f"上传失败：{result}")
    except Exception as e:
        print(f"上传异常：{str(e)}")
        raise
    finally:
        files["file"].close()

# 调用示例
if __name__ == "__main__":
    upload_image(
        file_path="test.jpg",
        api_key="你的 API_KEY",
        domain="你的域名"
    )

# curl 命令行上传示例
curl -X POST "https://你的域名/api/upload" \
  -H "X-API-Key: 你的 API_KEY" \
  -F "file=@test.jpg" \
  -F "channel=aiyun" \
  -v

开始使用爱云图床 API

无需复杂配置，一行代码即可集成，为你的项目提供稳定高效的图片存储服务

立即对接查看完整文档