1Що це і для кого
API дозволяє завантажувати фото на IMGpx зі своїх програм і отримувати ті самі посилання, що й на сайті: сторінку фото, пряме посилання, мініатюру, BB-код і HTML. Тільки фото — формати й розмір файлу такі самі, як при завантаженні через сайт.
Адреса: https://api.imgpx.com/v1 — тільки HTTPS. Відповіді — JSON.
2Як отримати ключ
1. Зареєструйтесь і підтвердіть пошту. 2. Відкрийте Налаштування → API. 3. Поставте галочку «Мій проєкт некомерційний» і натисніть «Створити ключ». Ключ показується один раз — одразу збережіть його.
Ключ передається тільки в заголовку: Authorization: Bearer ВАШ_КЛЮЧ. У адресі (?key=) чи в тілі запиту ключ не приймається — так він не потрапить у логи серверів та історію браузера. Не вставляйте ключ у код сторінки, яку бачать відвідувачі: запити до API з чужих сторінок у браузері заборонені.
3Ліміти
| Безкоштовно | |
|---|---|
| Фото на місяць | 1 000 |
| Фото на добу | 100 |
| Запитів за хвилину | 30 |
| Список «Мої фото» через API | останні 1 000 |
| Розмір файлу й формати | як при завантаженні через сайт |
| Ключів | 1 |
Місяць і доба рахуються за вашим часовим поясом (Налаштування → Часовий пояс). Видалене фото ліміт не повертає. Залишок — у відповіді GET /v1/me та в заголовках: X-Upload-Month-Remaining, X-Upload-Day-Remaining; запити за хвилину — X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
4Завантаження фото
POST /v1/upload — файл (multipart/form-data) або base64 у полі image. Тільки POST.
# curl curl -X POST https://api.imgpx.com/v1/upload \ -H "Authorization: Bearer ВАШ_КЛЮЧ" \ -F "[email protected]"
# Python import requests r = requests.post("https://api.imgpx.com/v1/upload", headers={"Authorization": "Bearer ВАШ_КЛЮЧ"}, files={"image": open("photo.jpg", "rb")}) print(r.json()["data"]["url"])
# base64 (PHP) $ch = curl_init('https://api.imgpx.com/v1/upload'); curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer ВАШ_КЛЮЧ'], CURLOPT_POSTFIELDS => ['image' => base64_encode(file_get_contents('photo.jpg'))]]); $answer = json_decode(curl_exec($ch), true);
| Параметр | Опис |
|---|---|
image | файл або base64 (обов’язково). Посилання на фото не приймаються. |
name | назва файлу (необов’язково) |
expiration | автовидалення через N секунд: від 60 до 15 552 000 (180 днів). Без параметра фото зберігається як звичайно. |
private | 1 — особистий файл: бачите тільки ви (якщо особисті файли вам доступні) |
5Відповідь
{
"success": true,
"status": 200,
"data": {
"id": "aB3dE7kLm2Qx",
"page": "https://imgpx.com/Xy7Kp2Lm",
"url": "https://imgpx.com/aB3dE7kLm2Qx.jpg",
"thumb": "https://imgpx.com/thumbnail/aB3dE7kLm2Qx.webp",
"width": 1920, "height": 1080, "size": 284120, "format": "jpg",
"private": false, "expires_at": null,
"bbcode": "[url=…][img]…[/img][/url]", "bbcode_thumb": …,
"html": "<a href=…><img src=… /></a>", "html_thumb": …, "markdown": …,
"delete_url": "https://api.imgpx.com/v1/delete/aB3dE7kLm2Qx/…"
}
}Формат фото може змінитися так само, як на сайті: наприклад, PNG стає WebP, якщо це ввімкнено у вашому профілі. delete_url видаляє фото без ключа — не публікуйте його.
6Мої фото та видалення
| Метод | Що робить |
|---|---|
GET /v1/files?page=1&per_page=50 | ваші фото, від нових до старих (до 100 на сторінку; останні 1 000) |
GET /v1/files/{id} | одне фото |
DELETE /v1/files/{id} | видалити фото |
delete_url | посилання з відповіді на завантаження — відкриває сторінку з кнопкою «Видалити» (для ShareX) |
GET /v1/me | ваші ліміти, скільки використано й коли оновиться |
Чужі фото API не показує й не видаляє: відповідь 404, ніби фото немає.
7Помилки
{ "success": false, "status": 429, "error": { "code": "limit_day", "message": "…" } }| Код | Що означає |
|---|---|
| 400 | невірний запит: немає фото, неправильний base64, expiration, ключ в адресі |
| 401 | немає ключа або ключ невірний |
| 403 | API вимкнено для вашого акаунта, ключ відкликано або потрібен HTTPS |
| 404 | фото не знайдено |
| 413 | файл завеликий |
| 415 | це не фото або цей формат вам недоступний |
| 429 | ліміт вичерпано — повторіть після часу з заголовка Retry-After |
Багато невірних ключів з однієї адреси — вона на годину втрачає доступ до API. Ключ, який отримує дуже багато помилок поспіль (наприклад, зациклений скрипт), вимикається автоматично — повідомлення прийде у дзвіночок.
8ShareX
Завантажте готовий файл налаштувань і відкрийте його двічі — ShareX додасть IMGpx як сервіс завантаження. Потім у ShareX: Destinations → Custom uploader settings → Headers, замініть YOUR_KEY на свій ключ.
9Правила API
- Тільки особисті та некомерційні проєкти. Для комерційного використання — напишіть нам.
- Ті самі правила, що й для сайту: Умови використання, розділ «Що не можна завантажувати».
- Не передавайте ключ іншим і не публікуйте його. Загубили чи засвітили — відкличте в профілі й створіть новий.
- За порушення правил чи надмірне навантаження ключ вимикається без попередження.

