cURL
curl --request POST \ --url https://api.foxapi.cc/v1/files/upload/stream \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: multipart/form-data' \ --form file='@example-file' \ --form file_name=photo.png \ --form 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
要上传的文件
自定义文件名(含扩展名),不提供时使用上传文件的原始文件名
"photo.png"
存储空间不足时是否自动清理最早上传的文件以腾出空间
说明:
true
false
文件上传成功
文件ID
"file-1757165031-a1b2c3"
原始文件名
上传文件的可访问URL
"https://cdn.foxapi.cc/uploads/20260319/a1b2c3d4e5f6/photo.png"
文件大小(字节)
204800
上传时间戳
1757165031