API version 1

Freeimage.host's API v1 allows to upload pictures.

API Key


API call

Request method

API v1 calls can be done using the POST or GET request methods but since GET request are limited by the maximum allowed length of an URL you should prefer the POST request method.

Request URL


Parameters

  • key (required) The API key.
  • action What you want to do [values: upload].
  • source Either a image URL or a base64 encoded image string. You can also use FILES["source"] in your request.
  • format Sets the return format [values: json (default), redirect, txt].

Example call

Note: Always use POST when uploading local files. Url encoding may alter the base64 source due to encoded characters or just by URL request length limit due to GET request.

API response

API v1 responses display all the image uploaded information in JSON format.

JSON the response will have headers status codes to allow you to easily notice if the request was OK or not. It will also output the status properties.

Example response (JSON)

Нажмите на миниатюру, чтобы отредактировать изображение или изменить его размер
Отредактируйте изображение касанием окна предпросмотра.
Вы можете добавить изображения с вашего компьютера или добавить ссылки на изображения.
Загружается 0 изображение (0% завершено)
Загружается очередь изображений. Это может занять некоторое время.
Загрузка завершена
Загруженное содержимое добавлено к альбому . Вы можете создать новый альбом с загруженным содержимым.
Загруженное содержимое добавлено к альбому .
Вы можете создать новый альбом с загруженным содержимым. Вы должны создать аккаунт или войти, чтобы сохранить это содержимое в свой аккаунт.
Не было загружено ни одного изображение.
В процессе обработки вашего запроса произошла ошибка.
    Внимание: Некоторые изображения не были загружены. подробнее
    Проверьте отчет об ошибках для получения более подробной информации.
    JPG PNG BMP GIF WEBP 64 MB