API 版本 1.1

通过 API 可使用程序上传文件，将本站的上传功能集成到您的应用中。

密钥

在您的 设置 中获取个人 API 密钥。

请求 方式

API V1 支持 POST 和 GET 请求。

建议使用 POST 请求。

请求 URL

授权

API V1.1 支持在 X-API-Key 请求头中传入 API 密钥进行身份验证。

参数

source

二进制文件、Base64 数据或图片 URL。

key (可选)

API 密钥。无法通过请求头进行身份验证时，可使用此参数。

title (可选)

文件标题。未提供时自动从元数据中读取。

description (可选)

文件描述。未提供时自动从元数据中读取。

tags (可选)

文件标签。多个标签用逗号分隔。

album_id (可选)

目标相册 ID；该相册必须属于此 API 密钥对应的用户。

category_id (可选)

分类 ID，用于指定文件所属分类。

width (可选)

调整后的目标宽度，高度自动计算。

expiration (可选)

自动删除文件前的保留时长，使用时间间隔格式。例如 PT5M 表示 5 分钟后，P3D 表示 3 天后。

format (可选)

响应格式 [json, redirect, txt]。

use_file_date (可选，仅限管理员)

是否使用 EXIF 拍摄日期代替上传日期 [0, 1]。

调用示例

API 响应

API V1 的响应取决于 format 参数（json、txt、redirect）。默认使用 JSON，响应包含 status_txt 和 status_code 字段。

响应示例 (JSON)

{
  "status_code": 200,
  "success": {
    "message": "file uploaded",
    "code": 200
  },
  "image": {
    "name": "Badgers-animated-music-video",
    "extension": "mp4",
    "size": 3011299,
    "width": 496,
    "height": 360,
    "date": "2024-10-10 16:58:00",
    "date_gmt": "2024-10-10 19:58:00",
    "title": "Badgers animated music video MrWeebl",
    "tags": [],
    "description": null,
    "storage_mode": "datefolder",
    "checksum": "7a120d5c28de264bdbb934f023a628fd",
    "source_checksum": null,
    "original_filename": "Badgers _ animated music video _ MrWeebl.mp4",
    "original_exifdata": null,
    "views": 0,
    "category_id": null,
    "chain": 21,
    "thumb_size": 21212,
    "medium_size": 0,
    "frame_size": 19804,
    "expiration_date_gmt": "2024-10-10 20:28:00",
    "likes": 0,
    "is_animated": 0,
    "is_approved": 1,
    "is_360": 0,
    "duration": 73,
    "type": "video",
    "tags_string": "",
    "file": {
      "resource": {
        "type": "url"
      }
    },
    "id_encoded": "ZfGd",
    "filename": "Badgers-animated-music-video.mp4",
    "mime": "video/mp4",
    "url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.mp4",
    "ratio": 1.3777777777777778,
    "size_formatted": "3 MB",
    "frame": {
      "filename": "Badgers-animated-music-video.fr.jpeg",
      "name": "Badgers-animated-music-video.fr",
      "mime": "image/jpeg",
      "extension": "jpeg",
      "url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.fr.jpeg",
      "size": 19804
    },
    "image": {
      "filename": "Badgers-animated-music-video.mp4",
      "name": "Badgers-animated-music-video",
      "mime": "video/mp4",
      "extension": "mp4",
      "url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.mp4",
      "size": 3011299
    },
    "thumb": {
      "filename": "Badgers-animated-music-video.th.jpeg",
      "name": "Badgers-animated-music-video.th",
      "mime": "image/jpeg",
      "extension": "jpeg",
      "url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.th.jpeg",
      "size": 21212
    },
    "url_frame": "http://localhost/images/2024/10/10/Badgers-animated-music-video.fr.jpeg",
    "medium": {
      "filename": null,
      "name": null,
      "mime": null,
      "extension": null,
      "url": null
    },
    "duration_time": "01:13",
    "url_viewer": "http://localhost/clip/Badgers-animated-music-video-MrWeebl.ZfGd",
    "path_viewer": "/clip/Badgers-animated-music-video-MrWeebl.ZfGd",
    "url_short": "http://localhost/clip/ZfGd",
    "display_url": "http://localhost/images/2024/10/10/Badgers-animated-music-video.fr.jpeg",
    "display_width": 496,
    "display_height": 360,
    "views_label": "views",
    "likes_label": "likes",
    "how_long_ago": "moments ago",
    "date_fixed_peer": "2024-10-10 19:58:00",
    "title_truncated": "Badgers animated music vi...",
    "title_truncated_html": "Badgers animated music vi...",
    "is_use_loader": false,
    "display_title": "Badgers animated music video MrWeebl",
    "delete_url": "http://localhost/clip/ZfGd/delete/e8b07479818bc58d3b9849c431e9c2b28827ccce7809ed4f"
  },
  "status_txt": "OK"
}

响应示例 (text)

响应示例 (redirect)