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.