透過 API 可使用程式上傳檔案，將本站的上傳功能整合至您的應用程式。
金鑰
在您的 設定 中取得個人 API 金鑰。
請求 方式
API V1 支援 POST 與 GET 請求。
建議使用 POST 請求。
請求 URL
https://imgcc.cloud/api/1/upload
授權
API V1.1 支援在 X-API-Key 標頭中傳入 API 金鑰進行身分驗證。
X-API-Key: chv_key_here
參數
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]。
呼叫範例
curl --fail-with-body -X POST \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "source=@image.jpeg" \
https://imgcc.cloud/api/1/upload
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)
http://localhost/images/2024/10/10/Badgers-animated-music-video.mp4
回應範例 (redirect)
Location: /clip/Badgers-animated-music-video-MrWeebl.ZfGd