cURL
curl --request POST \ --url https://api.foxapi.cc/v1/files/upload/url \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "url": "https://example.com/image.png", "file_name": "photo.png", "auto_cleanup": true } '
{ "id": "file-1757165031-a1b2c3", "filename": "photo.png", "url": "https://cdn.foxapi.cc/uploads/20260319/a1b2c3d4e5f6/photo.png", "size": 204800, "created": 1757165031 }
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
要下载的远程文件 URL
"https://example.com/image.png"
可选的文件名覆盖,不提供时从 URL 推断
"photo.png"
存储空间不足时是否自动清理最早上传的文件以腾出空间
说明:
true
false
文件上传成功
文件ID
"file-1757165031-a1b2c3"
原始文件名
上传文件的可访问URL
"https://cdn.foxapi.cc/uploads/20260319/a1b2c3d4e5f6/photo.png"
文件大小(字节)
204800
上传时间戳
1757165031