GIFYU :framed_picture:
Unofficial API of gifyu.com. Free hosting for images 🚀.
Get Started
npm install gifyu
const { gifyu } = require('gifyu')
import { gifyu } from 'gifyu'
Usage
gifyu(file/link, album)
.then(res => console.log(res));
gifyu('example/example_one.jpg')
.then(res => console.log(res));
- Using File Path + Title & Description
gifyu({
source: 'example/example_one.jpg',
filename: 'My Photo',
description: 'A Photo Got from LoremPicsum'
})
.then(res => console.log(res));
- Using File Path + Create Album
gifyu('example/example_one.jpg', {
title: 'My First Album',
description: 'Album about nothing',
privacy: 'private_but_link'
})
.then(res => console.log(res));
Note 🚀 :
privacy
is optional, either 'public'
or 'private_but_link'
or 'password'
.
public
: anyone can access your albumprivate_but_link
: anyone can't access unless you give them the linkpassword
: anyone can't access unless you give them the password
if you choose 'password'
you have to provide additional field 'password'
.
{
title: 'My First Album',
description: 'Album about nothing',
privacy: 'password',
password: 'hello123pass'
}
gifyu([
'example/example_one.jpg',
'example/example_two.jpg'
])
.then(res => console.log(res));
- Multiple File Path + Title & Description + Create Album
gifyu(
[
{
source: 'example/example_one.jpg',
filename: 'My Photo 1',
description: 'A Photo Got from LoremPicsum'
},
{
source: 'example/example_two.jpg',
filename: 'My Photo 2',
description: 'A Photo Got from LoremPicsum'
}
],
{
title: 'My First Album',
description: 'This is description',
privacy: 'private_but_link'
}
)
.then(res => console.log(res));
gifyu('https://picsum.photos/id/1/200/300')
.then(res => console.log(res));
- Using Link + Title & Description
gifyu({
source: 'https://picsum.photos/id/1/200/300',
filename: 'Example Link with Title & Description',
description: 'This image is taken from LoremPhotos'
}).then(res => console.log(res));
gifyu([
'example/example_one.jpg',
'https://picsum.photos/id/1/200/300',
'example/example_two.jpg'
]).then(res => console.log(res));
- Multiple Links and Paths + Create Album
gifyu(
[
'example/example_one.jpg',
'https://picsum.photos/id/1/200/300'
],
{
title: 'My First Album'
}
).then(res => console.log(res));
{
"status_code": 200,
"success": {
"message": "image uploaded",
"code": 200
},
"image": {
"name": "example_one66c008e5f4006540",
"extension": "jpg",
"size": 6266,
"width": "200",
"height": "300",
"date": "2021-09-21 03:24:18",
"date_gmt": "2021-09-21 02:24:18",
"description": null,
"nsfw": "1",
"storage_mode": "direct",
"md5": "006d04cd82d6ca661cd4adc6932f48b6",
"original_filename": "example_one.jpg",
"original_exifdata": "{\"FileName\":\"example_one.jpg\",\"FileDateTime\":\"1632191057\",\"FileSize\":\"6266\",\"FileType\":\"2\",\"MimeType\":\"image\\/jpeg\",\"SectionsFound\":\"ANY_TAG, IFD0, EXIF\",\"COMPUTED\":{\"html\":\"width=\\\"200\\\" height=\\\"300\\\"\",\"Height\":\"300\",\"Width\":\"200\",\"IsColor\":\"1\",\"ByteOrderMotorola\":\"0\",\"UserComment\":\"Picsum ID: 866\",\"UserCommentEncoding\":\"ASCII\"},\"Orientation\":\"1\",\"XResolution\":\"72\\/1\",\"YResolution\":\"72\\/1\",\"ResolutionUnit\":\"2\",\"YCbCrPositioning\":\"1\",\"Exif_IFD_Pointer\":\"102\",\"ExifVersion\":\"0210\",\"ComponentsConfiguration\":\"\\u0001\\u0002\\u0003\\u0000\",\"UserComment\":\"ASCII\\u0000\\u0000\\u0000Picsum ID: 866\",\"FlashPixVersion\":\"0100\",\"ColorSpace\":\"65535\",\"ExifImageWidth\":\"200\",\"ExifImageLength\":\"300\"}",
"views": "0",
"category_id": null,
"chain": "5",
"thumb_size": "6536",
"medium_size": "0",
"title": "example one",
"expiration_date_gmt": "2022-09-21 02:24:17",
"likes": "0",
"is_animated": "0",
"source_md5": null,
"is_approved": "1",
"is_360": "0",
"file": {
"resource": {
"type": "url"
}
},
"id_encoded": "PuBy",
"filename": "example_one66c008e5f4006540.jpg",
"mime": "image/jpeg",
"url": "https://s9.gifyu.com/images/example_one66c008e5f4006540.jpg",
"ratio": 0.6666666666666666,
"size_formatted": "6.3 KB",
"url_viewer": "https://gifyu.com/image/PuBy",
"url_short": "https://gifyu.com/image/PuBy",
"image": {
"filename": "example_one66c008e5f4006540.jpg",
"name": "example_one66c008e5f4006540",
"mime": "image/jpeg",
"extension": "jpg",
"url": "https://s9.gifyu.com/images/example_one66c008e5f4006540.jpg",
"size": 6266
},
"thumb": {
"filename": "example_one66c008e5f4006540.th.jpg",
"name": "example_one66c008e5f4006540.th",
"mime": "image/jpeg",
"extension": "jpg",
"url": "https://s9.gifyu.com/images/example_one66c008e5f4006540.th.jpg",
"size": "6536"
},
"display_url": "https://s9.gifyu.com/images/example_one66c008e5f4006540.jpg",
"display_width": "200",
"display_height": "300",
"views_label": "views",
"likes_label": "likes",
"how_long_ago": "moments ago",
"date_fixed_peer": "2021-09-21 02:24:18",
"title_truncated": "example one",
"title_truncated_html": "example one",
"is_use_loader": false
},
"request": {
"nsfw": 1,
"action": "upload",
"expiration": "0",
"timestamp": "1632191056328",
"type": "file",
"auth_token": "YOUR AUTH_TOKEN SHOULD BE HERE",
"cookie": "YOUR COOKIE SHOULD BE HERE TOO"
},
"status_txt": "OK"
}