API
Using vgy.me on your website or in your own tools is easy. You just need to make a POST method request to https://vgy.me/upload with your image in a field named file (or file[] for several images at once). The uploader will always return a JSON response.
Uploads need an account: include your userkey with every request. You can generate a userkey on your Account details page (go to the Userkeys tab). Requests without a valid userkey are rejected.
Limits: jpg, jpeg, png, gif (also webp and heic and heif, converted to JPEG, or PNG when transparent) · up to 20 MB per image · up to 20 images per request · up to 600 images per userkey per hour (over that, you get HTTP 429 until the hour is up).
Uploading with cURL
curl -F "file=@cat.png" -F "userkey=YOUR_KEY" https://vgy.me/upload
Optionally, you can also give your upload a title by adding a title field:
curl -F "file=@cat.png" -F "userkey=YOUR_KEY" -F "title=Beautiful Flowers" https://vgy.me/upload
To upload several images in one request, repeat the file[] field:
curl -F "file[]=@cat.png" -F "file[]=@dog.jpg" -F "userkey=YOUR_KEY" https://vgy.me/upload
Responses
For single-file uploads, it will return basic information for that upload, like below:
{
"error": false,
"size": 123456,
"filename": "abc123",
"ext": "png",
"url": "https://vgy.me/u/abc123",
"image": "https://i.vgy.me/abc123.png",
"delete": "https://vgy.me/delete/DemoDeleteURL"
}
For multi-file uploads, the uploader will always create a random album to store the multiple uploads in. The results will be a single URL to the album, as well as a list of all the uploads within that album:
{
"error": false,
"url": "https://vgy.me/album/DemoAlbm",
"upload_list": [
"https://i.vgy.me/Demo01.png",
"https://i.vgy.me/Demo02.png",
"https://i.vgy.me/Demo03.png"
]
}
If your userkey is assigned to an album, uploads made with it are placed in that album.
If anything is wrong, nothing from the request is stored and you get "error": true with a message for each file that failed (HTTP 422):
{
"error": true,
"messages": {
"cat.bmp": "Unsupported file extension detected.<br /><br /><strong>Supported extensions:</strong><br />jpg, jpeg, png, gif, webp, heic, heif"
}
}
{
"error": true,
"messages": {
"Unauthorized": "Anonymous uploads are not allowed."
}
}
ShareX
You can upload straight from ShareX for Windows. Save the following as vgy.me.sxcu, replace YOUR_KEY with your userkey, then double-click the file to add it as a custom uploader:
{
"Version": "15.0.0",
"Name": "vgy.me",
"DestinationType": "ImageUploader",
"RequestMethod": "POST",
"RequestURL": "https://vgy.me/upload",
"Body": "MultipartFormData",
"Arguments": {
"userkey": "YOUR_KEY"
},
"FileFormName": "file",
"URL": "{json:image}",
"DeletionURL": "{json:delete}",
"ErrorMessage": "{json:messages}"
}
Other tools work the same way: send a multipart POST to https://vgy.me/upload with file and userkey, and read image (direct link), url (viewer) and delete from the JSON response.