Please do not hesitate to contact support@june.se if you have questions or need a new image output format for your application.

Using Comet’s image endpoint to access images

If you want to use an image stored in Comet you can do so by addressing it like this:
https://image-vodhub.junecomet.com[image Guid]/[key].[image extension]

You should find the image GUID in the api you are using and the format keys that you can use are listed in the table at the end of this document.
If you need a new format contact us at support@june.se.

Crops and sizes

The images can be requested in different crops or sizes.

Image with a 4:3 ratio crop
Image URL for a 4:3 ratio crop: https://image-vodhub.junecomet.comtba/4x3_Max.jpg

Same image returned with different crops

Image with a 16:9 ratio crop
Image URL for a 16:9 crop: https://image-vodhub.junecomet.comtba/16x9_Max.jpg
Image with a 1:1 ratio crop
Image URL for a 1:1 crop: https://image-vodhub.junecomet.comtba/1x1_Max.jpg
Image with a 7:10 ratio crop
Image URL for a 7:10 crop: https://image-vodhub.junecomet.comtba/7x10_Max.jpg

Same image returned with same crop but in different sizes

Image with a 16:7 ratio crop
Image URL for a 16:7 crop: https://image-vodhub.junecomet.comtba/16x7_Max.jpg
Image with a 16:7 ratio crop
Image URL for a 16:7 crop with max width 400px: https://image-vodhub.junecomet.comtba/Star_16x7_400x.jpg
Image with a 16:7 ratio crop
Image URL for a 16:7 crop with max width 200px: https://image-vodhub.junecomet.comtba/Star_16x7_200x.jpg

Image extensions

Images can be returned in the following formats: jpg, png, webp, tiff, gif, bmp.

API response

If an image is not returned within 30 seconds the API will respond with 202 Accepted and you should try to request the image again.
If the image does not exist the API will respond with 404 Not found.
If you are not allowed to view the image the API will respond with 401 UnAuthorized.

Available formats

The formats without max width or max height will have dimensions depending on the original image and the aspect ratio.

Key AspectRatio Width Height Enlarge if needed Example
16x7_Max 16x7 True https://image-vodhub.junecomet.comtba/16x7_Max.jpg
16x9_Max 16x9 False https://image-vodhub.junecomet.comtba/16x9_Max.jpg
1x1_Max 1x1 True https://image-vodhub.junecomet.comtba/1x1_Max.jpg
2x3_Max 2x3 True https://image-vodhub.junecomet.comtba/2x3_Max.jpg
4x1_Max 4x1 True https://image-vodhub.junecomet.comtba/4x1_Max.jpg
4x3_Max 4x3 False https://image-vodhub.junecomet.comtba/4x3_Max.jpg
7x10_Max 7x10 False https://image-vodhub.junecomet.comtba/7x10_Max.jpg
character1x1 1x1 400 400 False https://image-vodhub.junecomet.comtba/character1x1.jpg
Comet_16x9_100x56 16x9 100 56 True https://image-vodhub.junecomet.comtba/Comet_16x9_100x56.jpg
Comet_16x9_1600x900 16x9 1600 900 True https://image-vodhub.junecomet.comtba/Comet_16x9_1600x900.jpg
Comet_16x9_200x112 16x9 200 112 True https://image-vodhub.junecomet.comtba/Comet_16x9_200x112.jpg
Comet_16x9_400x224 16x9 400 224 True https://image-vodhub.junecomet.comtba/Comet_16x9_400x224.jpg
Comet_16x9_800x450 16x9 800 450 True https://image-vodhub.junecomet.comtba/Comet_16x9_800x450.jpg
crop16x7_w200_h88 16x7 200 True https://image-vodhub.junecomet.comtba/Star_16x7_200x.jpg
crop16x9_w200 16x9 200 True https://image-vodhub.junecomet.comtba/crop16x9_w200.jpg
crop16x9extramargin 16x9_extramargin False https://image-vodhub.junecomet.comtba/crop16x9extramargin.jpg
crop16x9extramargin_w100_h56 16x9_extramargin 100 True https://image-vodhub.junecomet.comtba/crop16x9extramargin_w100_h56.jpg
crop16x9extramargin_w1920_h1080 16x9_extramargin 1920 True https://image-vodhub.junecomet.comtba/crop16x9extramargin_w1920_h1080.jpg
crop1x1_w200_h200 1x1 200 True https://image-vodhub.junecomet.comtba/crop1x1_w200_h200.jpg
crop2x3_w200_h300 2x3 200 True https://image-vodhub.junecomet.comtba/crop2x3_w200_h300.jpg
crop4x1_w200_h50 4x1 200 True https://image-vodhub.junecomet.comtba/crop4x1_w200_h50.jpg
crop7x10_w200_h286 7x10 200 True https://image-vodhub.junecomet.comtba/crop7x10_w200_h286.jpg
FreeForm_Max Freeform False https://image-vodhub.junecomet.comtba/FreeForm_Max.jpg
Original - True https://image-vodhub.junecomet.comtba/Original.jpg
Star_16x7_400x 16x7 400 True https://image-vodhub.junecomet.comtba/Star_16x7_400x.jpg
Star_16x9_100x100 16x9 100 100 True https://image-vodhub.junecomet.comtba/Star_16x9_100x100.jpg
Star_16x9_400x 16x9 400 True https://image-vodhub.junecomet.comtba/Star_16x9_400x.jpg
Star_1x1_400x 1x1 400 True https://image-vodhub.junecomet.comtba/Star_1x1_400x.jpg
Star_2x3_400x 2x3 400 True https://image-vodhub.junecomet.comtba/Star_2x3_400x.jpg
Star_4x1_100x100 4x1 100 100 True https://image-vodhub.junecomet.comtba/Star_4x1_100x100.jpg
Star_4x1_400x 4x1 400 True https://image-vodhub.junecomet.comtba/Star_4x1_400x.jpg
Star_4x3_100x100 4x3 100 100 True https://image-vodhub.junecomet.comtba/Star_4x3_100x100.jpg
Star_4x3_200x 4x3 200 True https://image-vodhub.junecomet.comtba/Star_4x3_200x.jpg
Star_4x3_400x 4x3 400 True https://image-vodhub.junecomet.comtba/Star_4x3_400x.jpg
Star_7x10_100x100 7x10 100 100 True https://image-vodhub.junecomet.comtba/Star_7x10_100x100.jpg
Star_7x10_400x 7x10 400 True https://image-vodhub.junecomet.comtba/Star_7x10_400x.jpg
Star_FreeForm_100x Freeform 100 100 True https://image-vodhub.junecomet.comtba/Star_FreeForm_100x.jpg
Star_None_1200x1200 - 1200 1200 True https://image-vodhub.junecomet.comtba/Star_None_1200x1200.jpg
Star_None_200x - 200 True https://image-vodhub.junecomet.comtba/Star_None_200x.jpg
Star_None_2400x2400 - 2400 2400 True https://image-vodhub.junecomet.comtba/Star_None_2400x2400.jpg
Star_None_300x - 300 True https://image-vodhub.junecomet.comtba/Star_None_300x.jpg
Star_None_400x - 400 True https://image-vodhub.junecomet.comtba/Star_None_400x.jpg
Star_None_600x - 600 True https://image-vodhub.junecomet.comtba/Star_None_600x.jpg
Star_None_x300 - 300 False https://image-vodhub.junecomet.comtba/Star_None_x300.jpg
Star_None_x600 - 600 False https://image-vodhub.junecomet.comtba/Star_None_x600.jpg
Star_None_x600_notransform - 600 False https://image-vodhub.junecomet.comtba/Star_None_x600_notransform.jpg
Star_Ultraforge_100x100 7x2 100 100 True https://image-vodhub.junecomet.comtba/Star_Ultraforge_100x100.jpg
Star_Ultraforge_400x 7x2 400 True https://image-vodhub.junecomet.comtba/Star_Ultraforge_400x.jpg
Star_WorkingCopy_1200x1200 - 1000 1000 False https://image-vodhub.junecomet.comtba/Star_WorkingCopy_1200x1200.jpg
Star_WorkingCopy_2400x2400 - 2400 2400 False https://image-vodhub.junecomet.comtba/Star_WorkingCopy_2400x2400.jpg
Star_WorkingCopySquare_300x300 - 300 300 False https://image-vodhub.junecomet.comtba/Star_WorkingCopySquare_300x300.jpg
Ultraforge_Max 7x2 False https://image-vodhub.junecomet.comtba/Ultraforge_Max.jpg
ultraforge_w200_h58 7x2 200 True https://image-vodhub.junecomet.comtba/ultraforge_w200_h58.jpg
videoproxy - True https://image-vodhub.junecomet.comtba/videoproxy.jpg