Документація API

API YourImageShare дає змогу завантажувати, переглядати й видаляти файли з коду. Це невеликий JSON/REST API: SDK не потрібен, достатньо HTTP-клієнта та API-ключа. Також доступні офіційні бібліотеки для JavaScript, Python і MCP.

Усі клієнтські бібліотеки та інструменти нижче мають відкритий код. Переглядайте код, повідомляйте про проблеми або долучайтеся до розробки в нашому офіційному репозиторії на GitHub: github.com/yourimageshare/yourimageshare.

Базова адреса: https://yourimageshare.com/api · Формат: JSON на вході й виході, крім завантаження файлів, яке йде як multipart/form-data · Авторизація: API-ключ у кожному запиті. · Специфікація для машин: /openapi.json (OpenAPI 3.1), для агентів і генераторів коду, яким не треба розбирати цю сторінку.

Як отримати API-ключ

Увійдіть в обліковий запис, перейдіть у Мій акаунт і відкрийте вкладку API. Там показано ваш ключ і кнопку Згенерувати знову. Новий ключ одразу робить старий недійсним, тож перед натисканням оновіть його всюди, де він використовується.

Також на цій вкладці є другий, незалежний ключ лише для завантаження: дивіться підказку нижче та розділ Плагіни для форумів, щоб зрозуміти, коли його використовувати.

Авторизація

Передавайте ключ у заголовку. Це кращий варіант, бо рядки запитів часто потрапляють у журнали доступу, журнали проксі та заголовки Referer:

X-API-Key: YOUR_API_KEY

Параметр запиту ?key= теж працює: його залишено для сумісності зі старішими інтеграціями та для швидких разових команд curl. Якщо вказано обидва способи, пріоритет має заголовок.

?key=YOUR_API_KEY

Порада: ставтеся до ключа як до пароля: будь-хто з ним може завантажувати, переглядати, змінювати й видаляти файли у вашому акаунті. Кожен успішний запит записується й відображається діаграмою на вкладці API сторінки вашого акаунта, з розбивкою за днями та типами запитів. Якщо ключ має лежати там, де його можуть побачити інші, наприклад у плагіні форуму чи публічному файлі конфігурації, використовуйте натомість ключ лише для завантаження з тієї ж вкладки: він уміє тільки завантажувати, а перегляд списку, отримання, зміна та видалення з ним завершуються помилкою 401.

Ендпоінти

Завантаження, перегляд списку та видалення мають спільні авторизацію й ліміти запитів; великі файли можна спершу надіслати частинами.

POST /api: завантажити файл

Завантажує один файл для авторизованого акаунта.

ПолеТипОбов'язковеОпис
uploadsфайлодне з трьохФайл для завантаження, до 100MB (ліміт для одного запиту через нашу мережу). Один файл на запит: цей ендпоінт не підтримує пакетне завантаження кількох файлів.
urlрядокПублічне http(s)-посилання на зображення або відео. Ми завантажуємо файл самі, тож працюють файли до 200MB.
upload_idрядокФайл, попередньо надісланий частинами на POST /api/chunk, до 200MB.
filenameрядокніЗ upload_id: початкова назва файлу.
expires_inціле числоніАвтоматично видалити це завантаження через вказану кількість секунд (від 60 до 31 536 000, тобто від 1 хвилини до 1 року). Не вказуйте, якщо потрібне звичайне постійне завантаження.
allow_duplicateбулевеніЗберегти нову копію, навіть якщо ваш акаунт уже завантажував точно такий самий файл (див. duplicate нижче).
keep_originalбулевеніЗберегти зображення точно таким, як завантажено. Без цього JPG/PNG понад 1 MB оптимізуються до WebP. Метадані, як-от GPS, видаляються в обох випадках.
visibilityрядокніunlisted (за замовчуванням): файл і його сторінка працюють для всіх, хто має посилання, але ніде не показуються у списках. private: лише файл; посилання на сторінку для всіх, крім вас, одразу веде на файл (без коментарів, реакцій і реклами). public: показується на сайті та індексується.
titleрядокніДо 90 символів, показується на сторінці завантаження.
descriptionрядокніДо 500 символів.

Підтримувані типи: зображення JPG, PNG, GIF, WEBP, AVIF, BMP, TIFF, HEIC або HEIF; відео MP4, WEBM, AVI, MOV, MKV, MPEG, WMV, FLV або 3GP (точний перелік може розширюватися). HEIC/HEIF і TIFF зберігаються як WebP, відео не у форматах MP4/WebM конвертується в MP4, а більші зображення JPEG/PNG невдовзі після завантаження конвертуються у WebP, якщо це помітно зменшує їхній розмір. Максимальний розмір: 200MB; завеликі або нечитабельні файли відхиляються з помилкою 422.

Відповідь: 200 OK:

{
  "type": "success",
  "msg": "success",
  "data": {
    "id": "aB3xY9qRz1",
    "type": "image",
    "path": "https://i.yourimageshare.com/aB3xY9qRz1.png",
    "src": "https://yourimageshare.com/ib/aB3xY9qRz1.png",
    "direct": "https://yourimageshare.com/ib/aB3xY9qRz1",
    "thumb": "https://i.yourimageshare.com/thumb-aB3xY9qRz1.webp",
    "width": 1920,
    "height": 1080,
    "size": 482113,
    "locked": false,
    "visibility": "unlisted",
    "title": null,
    "description": null,
    "expires_at": null,
    "duplicate": false,
    "delete_url": "https://yourimageshare.com/delete#iV3x...k9"
  }
}
ПолеОпис
idУнікальний ідентифікатор файлу.
typeimage або video.
pathАдреса файлу у сховищі в тому вигляді, як його завантажено. Вона може змінитися невдовзі після конвертації файлу (WebP/MP4), тому зберігайте src, а не path.
srcПостійне пряме посилання на файл: завжди відкриває актуальний файл, підходить для src в <img>/<video> і для збереження.
directСторінка файлу на YourImageShare (назва, опис, коментарі, способи поділитися).
thumbМініатюра WebP шириною 280px (для відео це перший кадр) або null.
width, heightРозмір для показу в пікселях (з правильною орієнтацією; для відео це розмір кадру) або null, якщо невідомий.
sizeРозмір файлу в байтах, як він збережений.
lockedtrue, якщо завантаження захищене паролем.
visibilityprivate, unlisted або public (див. поле запиту вище).
title, descriptionЯк задано, або null. Текст проходить ту саму модерацію, що й на сайті.
delete_urlЛише для нових завантажень: приватне посилання, яке видаляє це завантаження без API-ключа. Показується один раз (зберігається лише хеш), тож збережіть його, якщо воно вам потрібне.
expires_atПозначка часу ISO 8601, коли це завантаження буде автоматично видалено, або null, якщо воно не має терміну дії.
duplicatetrue, якщо ваш акаунт уже завантажував точно такий самий файл: повертається те завантаження, а нове не зберігається. Не застосовується до завантажень із терміном дії та з allow_duplicate=1.

Завантаження з терміном дії: щойно настає expires_at, файл видаляється зі сховища, а сторінка завантаження починає повертати 410 Gone приблизно протягом 5 хвилин. Це не можна скасувати чи продовжити згодом: щоб видалити раніше, скористайтеся ендпоінтом DELETE, а якщо файл має зберігатися довше, завантажте його знову з новим expires_in.

POST /api/chunk: великі файли

Один запит може містити щонайбільше 100MB. Для більших файлів (до 200MB), а також щоб кожен запит був невеликим на повільному з'єднанні, надсилайте файл частинами по 5MB або менше, а потім завершіть запитом POST /api:

  1. Оберіть ідентифікатор завантаження: 32 випадкові шістнадцяткові символи.
  2. Для кожної частини надсилайте POST /api/chunk (multipart/form-data) із upload_id, index (від 0), total (кількість частин) і байтами в chunk. Відповідь: {"type": "success", "chunk_size": 5242880}.
  3. Надішліть POST /api з upload_id і filename замість uploads та будь-якими іншими полями завантаження. Відповідь така сама, як у звичайного завантаження.

Частини незавершеного завантаження видаляються через 2 години. До лімітів завантаження зараховується лише завершальний POST /api.

GET /api/{id} і PATCH /api/{id}: одне завантаження

GET повертає одне з ваших завантажень із тими самими полями, що й у списку нижче. PATCH змінює його visibility, title або description (поля форми або JSON; порожня назва чи опис очищає значення) і повертає оновлене завантаження. Обидва запити потребують повного API-ключа; 404, якщо у вашому акаунті немає такого завантаження.

curl -X PATCH https://yourimageshare.com/api/aB3xY9qRz1 \
  -H "X-API-Key: YOUR_API_KEY" -d visibility=public -d title="Sunset"

POST /api/{id}/replace: замінити файл

Підміняє файл у одному з ваших завантажень, зберігаючи його id, сторінку та всі посилання. Підходить будь-який дозволений тип, навіть інший (зображення може стати відео). Надішліть новий файл як uploads (або upload_id файлу, надісланого частинами через POST /api/chunk); keep_original працює так само, як і під час завантаження. Новий файл проходить ті самі перевірки та конвертації, що й нове завантаження, а попередня версія видаляється. Потрібен повний API-ключ; 404, якщо у вашому акаунті немає такого завантаження, 409, якщо воно захищене паролем або має обмеження переглядів.

curl -X POST https://yourimageshare.com/api/aB3xY9qRz1/replace \
  -H "X-API-Key: YOUR_API_KEY" -F uploads=@new-version.png

GET /api: список ваших завантажень

Повертає посторінковий список завантажень авторизованого акаунта (з будь-якого джерела: API, сайту чи редактора), спершу найновіші, по 50 на сторінку.

ПараметрДеОбов'язковийОпис
pageзапитніНомер сторінки, за замовчуванням 1.

Відповідь: 200 OK:

{
  "type": "success",
  "data": [
    {
      "id": "aB3xY9qRz1",
      "type": "image",
      "title": null,
      "path": "https://i.yourimageshare.com/aB3xY9qRz1.webp",
      "src": "https://yourimageshare.com/ib/aB3xY9qRz1.webp",
      "direct": "https://yourimageshare.com/ib/aB3xY9qRz1",
      "thumb": "https://i.yourimageshare.com/thumb-aB3xY9qRz1.webp",
      "width": 1920,
      "height": 1080,
      "size": 482113,
      "locked": false,
      "visibility": "unlisted",
      "description": null,
      "expires_at": null,
      "created_at": "2026-07-23T15:43:28+01:00"
    }
  ],
  "meta": { "current_page": 1, "last_page": 1, "total": 1 }
}

Поля тут означають те саме, що у відповіді на завантаження вище (для завантаження, захищеного паролем, path і thumb є короткочасними підписаними посиланнями). Щоб отримати одне завантаження за його id, скористайтеся GET /api/{id}.

DELETE /api/{id}: видалити завантаження

Остаточно видаляє одне із завантажень авторизованого акаунта. Через API це неможливо скасувати. {id} це значення, яке повертають як id ендпоінти завантаження та списку.

Відповідь: 200 OK:

{ "type": "success", "msg": "Deleted." }

404, якщо у вашому акаунті немає завантаження з таким id (воно або ніколи вам не належало, або вже видалене).

POST /api/compare: слайдер «до/після»

Створює порівняння «до/після» для двох ваших завантажених зображень: сторінку зі слайдером за адресою /c/{id}, яку також можна вбудувати на будь-який сайт. Ключ лише для завантаження теж підходить. Надішліть before і after (id завантажень, обов'язково), а також за бажанням title, label_before і label_after (за замовчуванням «Before» та «After»).

Відповідь: 201 Created:

{
  "type": "success",
  "id": "P7uAYy04VA",
  "url": "https://yourimageshare.com/c/P7uAYy04VA",
  "embed_url": "https://yourimageshare.com/embed/c/P7uAYy04VA",
  "embed": { "script": "<blockquote class=\"YISEmbed\" ...", "iframe": "<iframe ..." }
}

422, якщо хоч один id не належить вашим завантаженим зображенням (відео та зображення, захищені паролем, використовувати не можна).

Ліміти запитів

Кожен API-ключ має незалежні квоти на хвилину та на добу, а також загальніший добовий ліміт на IP-адресу як запобіжник від випадків, коли одна IP-адреса перебирає кілька ключів. Завантаження, перегляд списку та видалення мають спільні ліміти.

ПроміжокЛіміт за замовчуваннямОбласть дії
На хвилину20 запитівна API-ключ
На добу500 запитівна повний API-ключ
На добу2000 запитівна ключ лише для завантаження (плагіни, що виносять цілі медіатеки)
На добу2000 запитівна IP-адресу
За місяць (UTC)Завантажень: 3 000на акаунт, усі його ключі разом
На хвилину300 частинна API-ключ, лише POST /api/chunk

Місячна квота завантажень. Кожен обліковий запис може завантажувати 3 000 файлів на місяць через API; лічильник охоплює всі його ключі та інструменти, що їх використовують (SDK, плагіни, розширення браузера, MCP із ключем). Враховуються лише успішні завантаження: списки, видалення й невдалі запити не враховуються, а файл, надісланий частинами, враховується один раз. Лічильник скидається 1-го числа щомісяця (UTC). Лічильник поточного місяця дивіться в Мій акаунт > API. Після перевищення квоти POST /api повертає 429 із датою скидання. Квота діє з 1 січня 2027.

Ці ліміти можуть змінюватися. Кожна відповідь містить стандартні заголовки лімітів запитів:

X-RateLimit-Limit: 20
X-RateLimit-Remaining: 14

Після перевищення ліміту повертається 429 із заголовком Retry-After, який вказує, скільки секунд чекати.

Помилки

Кожна відповідь із помилкою має однаковий вигляд незалежно від ендпоінта чи причини:

{ "type": "error", "errors": "A human-readable description of what went wrong." }
СтатусЗначення
401API-ключ відсутній або недійсний.
403Акаунт або вашу поточну IP-адресу заблоковано для завантаження.
404У цьому акаунті немає завантаження з таким id (отримання, зміна, видалення).
413Запит перевищує 100MB. Надішліть файл частинами (POST /api/chunk) або передайте посилання на нього в url (до 200MB).
422Помилка перевірки: не передано файл чи посилання, непідтримуваний тип файлу, нечитабельні дані зображення, розміри понад ліміт 30000x30000px, файл понад 200MB, незавершений або прострочений upload_id, або url, який не вдалося завантажити (у повідомленні вказано причину).
429Перевищено ліміт запитів: див. розділ Ліміти запитів вище.
500Щось неочікувано пішло не так на сервері. Запит можна безпечно повторити.

Клієнтські бібліотеки

Офіційні SDK, які обгортають наведені вище ендпоінти, повертають типізовані результати та генерують виняток у разі помилок API, щоб вам не доводилося працювати з «сирим» HTTP.

JavaScript / TypeScript

Без залежностей, працює в Node.js і браузерах. Також є на JSR як @yourimageshare/yourimageshare: npx jsr add @yourimageshare/yourimageshare; той самий код, що публікується одразу як TypeScript.

npm install yourimageshare

Python

Одна залежність (requests), Python 3.8+.

pip install yourimageshare

PHP

Без залежностей Composer (використовує власне розширення PHP curl), PHP 7.4+. Код на GitHub.

composer require yourimageshare/yourimageshare-php

Go

Без залежностей (лише стандартна бібліотека), Go 1.18+. Повну довідку дивіться на pkg.go.dev.

go get github.com/yourimageshare/yourimageshare/go

Rust

Дві залежності (ureq для блокувального HTTP, без асинхронного середовища, та serde), Rust 1.70+. Код на GitHub.

cargo add yourimageshare

Ruby

Без залежностей від gem-пакетів (стандартні Net::HTTP + json), Ruby 2.7+. Код на GitHub.

gem install yourimageshare

.NET

Одна залежність (власний System.Text.Json від Microsoft), націлена на netstandard2.0, тож працює і з .NET Framework, і з сучасним .NET. Код на GitHub. Зібрана й перевірена на цьому робочому API; публікація в NuGet незабаром.

dotnet add package YourImageShare

Dart / Flutter

Одна залежність (http, власний пакет команди Dart), Dart 2.17+. Код на GitHub. Зібрана й перевірена на цьому робочому API; публікація на pub.dev незабаром.

dart pub add yourimageshare

Elixir

Одна залежність (Req), Elixir 1.14+. Повертає кортежі {:ok, result}| {:error, reason}, що прямо відповідає обробці помилок цього API в усіх інших SDK, а також варіанти зі знаком оклику, які генерують виняток. Код на GitHub, документація на HexDocs.

{:yourimageshare, "~> 1.1"}

MCP-сервер

Для ШІ-агентів для програмування (Claude Code, Cursor та інших MCP-сумісних інструментів): вставляйте скриншот у звіт про помилку, опис PR чи звернення до підтримки як справжнє посилання, а не як base64-блок чи ручне завантаження. Так само працює з Claude Desktop та будь-яким іншим MCP-клієнтом.

Хмарна версія, нічого встановлювати не треба: додайте її як віддалений MCP-сервер (у Claude: Settings › Connectors › Add custom connector; а також ChatGPT, Cursor, VS Code та інші клієнти, що приймають адресу сервера), вказавши API-ключ в адресі:

https://yourimageshare.com/mcp?key=YOUR_API_KEY

Клієнти, що дають змогу задавати заголовки, можуть натомість використати https://yourimageshare.com/mcp із Authorization: Bearer YOUR_API_KEY. Адреса з вашим ключем працює як пароль: тримайте її в таємниці, а якщо вона витече, отримайте новий ключ у розділі Мій акаунт. На хмарному сервері upload_image приймає публічне посилання (до 200MB) або вбудований вміст у base64 (до 15MB). Без ключа https://yourimageshare.com/mcp усе одно завантажує анонімно, як і сайт: лише unlisted або private, нижчі ліміти, а завантаження видаляється через delete_url, яке повертається у відповіді. Інші інструменти потребують ключа.

Локально: запустіть напряму через npx, без встановлення (він також може читати файли з вашого диска):

npx yourimageshare-mcp

Інструменти: upload_image (локальний файл, вбудований вміст або посилання, до 200MB, з необов'язковими видимістю, назвою й автовидаленням), list_uploads, get_upload, update_upload і delete_upload.

Також є в офіційному реєстрі MCP (як io.github.yourimageshare/yourimageshare) і в каталозі Glama, якщо ваш MCP-клієнт встановлює з одного з них.

Ви ще не працювали з MCP? Дивіться як підключити Claude і ChatGPT до цього API через MCP: там повна покрокова інструкція.

Усі десять мають ліцензію MIT. Немає офіційної бібліотеки для вашої мови? Приклади коду нижче показують, як викликати API напряму.

Приклади коду

curl

# Upload a file
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg"

# Upload from a link (files up to 200MB; one direct upload request stops at 100MB -
# bigger files go in pieces, see Large Files above)
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "url=https://example.com/video.mp4"

# Upload a file that auto-deletes after 1 hour
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg" \
  -F "expires_in=3600"

# List uploads
curl "https://yourimageshare.com/api" -H "X-API-Key: YOUR_API_KEY"

# Upload a file without a page of its own (file only) and give it a title
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg" \
  -F "visibility=private" \
  -F "title=Sunset"

# Look up one upload, then make it public
curl "https://yourimageshare.com/api/aB3xY9qRz1" -H "X-API-Key: YOUR_API_KEY"
curl -X PATCH "https://yourimageshare.com/api/aB3xY9qRz1" \
  -H "X-API-Key: YOUR_API_KEY" -d "visibility=public"

# Delete an upload
curl -X DELETE "https://yourimageshare.com/api/aB3xY9qRz1" -H "X-API-Key: YOUR_API_KEY"

JavaScript (fetch)

const API_KEY = 'YOUR_API_KEY';
const BASE = 'https://yourimageshare.com/api';

async function uploadFile(file) {
  const form = new FormData();
  form.append('uploads', file);

  const res = await fetch(BASE, {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY },
    body: form,
  });
  const json = await res.json();
  if (json.type !== 'success') throw new Error(json.errors);
  return json.data;
}

async function listUploads(page = 1) {
  const res = await fetch(`${BASE}?page=${page}`, {
    headers: { 'X-API-Key': API_KEY },
  });
  return res.json();
}

async function deleteUpload(id) {
  const res = await fetch(`${BASE}/${id}`, {
    method: 'DELETE',
    headers: { 'X-API-Key': API_KEY },
  });
  return res.json();
}

Python (requests)

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://yourimageshare.com/api"

HEADERS = {"X-API-Key": API_KEY}

# Upload a file
with open("/path/to/photo.jpg", "rb") as f:
    res = requests.post(BASE, headers=HEADERS, files={"uploads": f})
res.raise_for_status()
upload = res.json()["data"]

# List uploads
res = requests.get(BASE, headers=HEADERS, params={"page": 1})
uploads = res.json()

# Delete an upload
res = requests.delete(f"{BASE}/{upload['id']}", headers=HEADERS)

PHP (curl)

<?php

$apiKey = 'YOUR_API_KEY';
$base = 'https://yourimageshare.com/api';

// Upload a file
$curl = curl_init($base);
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: $apiKey"],
    CURLOPT_POSTFIELDS => ['uploads' => new CURLFile('/path/to/photo.jpg')],
    CURLOPT_RETURNTRANSFER => true,
]);
$upload = json_decode(curl_exec($curl), true)['data'];
curl_close($curl);

// List uploads
$curl = curl_init("$base?page=1");
curl_setopt($curl, CURLOPT_HTTPHEADER, ["X-API-Key: $apiKey"]);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$uploads = json_decode(curl_exec($curl), true);
curl_close($curl);

Go (net/http)

Офіційний Go SDK вище робить це за вас; цю «сиру» версію наведено для тих, хто не хоче додавати залежність.

package main

import (
    "bytes"
    "encoding/json"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

const apiKey = "YOUR_API_KEY"
const base = "https://yourimageshare.com/api"

func uploadFile(path string) (map[string]any, error) {
    file, err := os.Open(path)
    if err != nil {
        return nil, err
    }
    defer file.Close()

    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    part, _ := writer.CreateFormFile("uploads", path)
    io.Copy(part, file)
    writer.Close()

    req, _ := http.NewRequest("POST", base, body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("X-API-Key", apiKey)

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        return nil, err
    }
    defer res.Body.Close()

    var result map[string]any
    json.NewDecoder(res.Body).Decode(&result)
    return result, nil
}

Інструменти для скриншотів

Розширення для браузера, а також готові конфігурації та скрипти, що надсилають скриншоти просто на YourImageShare без ручного завантаження. Кожен із них завантажує через той самий ендпоінт /api, описаний вище.

Розширення для браузера (Chrome і Firefox)

Розширення YourImageShare Capture для Chrome і Firefox обходиться без скриптів і файлів конфігурації. Воно знімає видиму область, виділену мишею ділянку або всю сторінку з прокручуванням, відкриває вбудований редактор зі стрілками, текстом, розмиттям/замазуванням та іншими позначками, а потім завантажує результат, копіює його в буфер обміну або публікує на YourImageShare одним кліком. Публікація використовує той самий ендпоінт /api, описаний вище: один раз додайте свій API-ключ у налаштуваннях розширення, і кожна наступна публікація одразу повертає посилання, яким можна ділитися. Працює в Chrome на комп'ютері (та інших браузерах на Chromium), Firefox на комп'ютері і Firefox для Android.

Отримати YourImageShare Capture для Firefox Отримати YourImageShare Capture для Chrome

ShareX

Завантажте наведений нижче користувацький завантажувач, потім у ShareX перейдіть до Destinations > Custom uploader settings > Import > from file, відкрийте завантажений файл .sxcu і замініть YOUR_API_KEY у полі Headers на свій справжній ключ. Призначте його місцем призначення для зображень/файлів, і знімки завантажуватимуться автоматично.

Завантажити YourImageShare.sxcu

Видалення: посилання «Delete» для кожного завантаження в ShareX відкриває в браузері нашу сторінку видалення (одноразове delete_url завантаження), тож ви можете видалити знімок прямо з історії ShareX. Також можна видаляти завантаження в розділі Мій акаунт. Завантажували конфігурацію до жовтня 2026 року? Завантажте її ще раз, щоб це працювало.

Flameshot (Linux)

Невеликий shell-скрипт, який запускає flameshot gui, завантажує знімок і копіює посилання в буфер обміну. Призначте його на комбінацію клавіш у вашому середовищі робочого столу замість стандартної комбінації Flameshot.

Завантажити yis-flameshot-upload.sh

# One-time setup
chmod +x yis-flameshot-upload.sh
export YIS_API_KEY="YOUR_API_KEY"   # or add to ~/.config/yourimageshare/api_key

# Then bind this to a hotkey instead of calling flameshot directly:
/path/to/yis-flameshot-upload.sh

Greenshot (Windows)

Скрипт PowerShell для вбудованого в Greenshot призначення External command. Сумісний із Windows PowerShell 5.1, що постачається разом із Windows, тож додаткове встановлення не потрібне.

Завантажити yis-greenshot-upload.ps1

# One-time setup
setx YIS_API_KEY "YOUR_API_KEY"

# In Greenshot: Preferences > Destinations > External command > Settings
#   Command:   powershell.exe
#   Arguments: -ExecutionPolicy Bypass -File "C:\path\to\yis-greenshot-upload.ps1" "%1"

Плагіни для форумів

Додайте справжню кнопку «Завантажити зображення» біля редактора повідомлень вашого форуму. Кожен плагін завантажує через той самий ендпоінт /api, описаний вище, і вставляє BBCode у позицію курсора: без окремої вкладки і без ручного копіювання.

Нижче використовуйте ключ лише для завантаження, а не повний API-ключ. Кожен плагін виводить ключ у вихідному коді сторінки для кожного відвідувача, а ключ лише для завантаження (Мій акаунт > вкладка API) уміє тільки завантажувати: він не може переглядати чи видаляти ваші завантаження, навіть якщо хтось скопіює його зі сторінки.

Завантаження з форуму за замовчуванням приватні: зображення працює в повідомленні, але YourImageShare не створює для нього власної сторінки (без коментарів, реакцій і реклами). У кожному плагіні є налаштування для переходу на unlisted, якщо ви хочете також мати сторінку для всіх, хто має посилання.

phpBB

Справжнє розширення для phpBB 3.2/3.3. Розпакуйте в ext/, увімкніть у розділі Customise > Manage extensions, потім замініть YOUR_UPLOAD_ONLY_KEY у файлі подій шаблону розширення на свій справжній ключ лише для завантаження.

Завантажити для phpBB

SMF (Simple Machines Forum)

Справжній пакет для SMF: встановіть через Admin > Package Manager, потім замініть YOUR_UPLOAD_ONLY_KEY у Sources/yis_forumupload.php на свій справжній ключ лише для завантаження.

Завантажити для SMF

MyBB

Справжній плагін для MyBB 1.8. Скопіюйте в inc/plugins/, активуйте в розділі Configuration > Plugins, потім замініть YOUR_UPLOAD_ONLY_KEY у файлі плагіна на свій справжній ключ лише для завантаження.

Завантажити для MyBB

FluxBB, PunBB і ZetaBoards

У них немає формальної системи плагінів, тож це невеликий фрагмент коду, який вставляється прямо у ваш шаблон (FluxBB/PunBB) або в Admin CP (ZetaBoards). Повні інструкції з копіювання для кожного:

Інструкція для FluxBB Інструкція для PunBB Інструкція для ZetaBoards

Плагін для WordPress

Виносьте медіатеку на YourImageShare замість локального диска. Нові завантаження зображень/відео автоматично йдуть через той самий ендпоінт /api, описаний вище, локальний файл (і кожен згенерований розмір мініатюри) видаляється після підтвердження завантаження, а кожна адреса вкладення WordPress (блоковий редактор, головні зображення, галереї, REST API) веде на файл, розміщений на YourImageShare. Жодних шорткодів і змін у вашій роботі.

  • Масово виносьте наявну медіатеку у фоновому режимі (або командою wp yis offload --all), а не лише нові завантаження
  • Зображення та відео, уже вставлені в записи, продовжують працювати після видалення локальних файлів
  • Мініатюри та srcset використовують нашу мініатюру 280px, тож малі слоти для зображень не завантажують файли повного розміру
  • Файли до 200MB, що надсилаються частинами, тож великі відео ніколи не навантажують спільний хостинг
  • Будь-який винесений файл можна будь-коли повернути в локальне сховище
  • Колонка в медіатеці показує, що винесено, а що ще залишилося локально
  • Винесені файли зберігаються як private: вони завантажуються всюди, де їх використовує ваш сайт, але не мають власної сторінки на YourImageShare

Використовує ваш ключ лише для завантаження, а не API-ключ. Необов'язковий повний API-ключ потрібен лише тоді, коли ви хочете, щоб винесені файли видалялися з YourImageShare, коли ви видаляєте їх у WordPress.

Отримати на WordPress.org Завантажити ZIP

У WordPress: Plugins > Add New, знайдіть YourImageShare Media Offload, потім натисніть Install і Activate.

Кнопка завантаження для будь-якого сайту

Дайте відвідувачам кнопку «Завантажити» на будь-якому сайті: у формі коментаря, на сторінці підтримки, на форумі, для якого в нас немає плагіна, на статичному сайті. Вставте два рядки; акаунт і серверний код не потрібні.

<a class="yis-upload" href="https://yourimageshare.com/" data-target="#message" data-format="bbcode">Image and video hosting by YourImageShare</a>
<script src="https://yourimageshare.com/w.js" async></script>

Обидва атрибути необов'язкові: без них кнопка показує посилання з кнопкою «Копіювати». Вікно завантаження будується навколо посилання.

  • Завантаження відбувається прямо на вашій сторінці: натисніть кнопку, перетягніть на неї файли або вставте в неї скриншот, одразу кілька файлів, зі смугою прогресу та мініатюрою
  • Зображення, вставлені чи перетягнуті прямо в поле, вказане в data-target (будь-яке текстове поле, поле введення або редагований блок), також завантажуються, а посилання додаються в це поле; без цілі вони з'являються під кнопкою з кнопкою «Копіювати»
  • data-format: url (пряме посилання на файл, за замовчуванням), page, bbcode, html або markdown; data-label змінює текст кнопки
  • data-key (необов'язково): ваш ключ лише для завантаження (Мій акаунт > API). Тоді завантаження потрапляють у ваш акаунт з вашими лімітами. Без ключа завантаження анонімні та unlisted, з добовим лімітом на відвідувача і на сайт
  • Розробники можуть слухати подію yis:upload у вікні завантаження: event.detail.item містить {id, type, page, url, thumb}
  • Файли до 95 MB через кнопку (більші на сайті). Наша модерація та умови діють як завжди; кожен відвідувач отримує власне посилання для видалення

Кнопка малюється в окремому ізольованому блоці, тож CSS вашого сайту не може її зламати. Невелике посилання «Image and video hosting by YourImageShare» залишається видимим усередині вікна завантаження.

Команда для iPhone та iPad

Завантажуйте з меню «Поділитися» будь-якого застосунку (Фото, Файли, Safari, скриншот) і отримуйте посилання в буфері обміну. Нічого встановлювати не треба, і акаунт не потрібен.

Щоб створити її самостійно в застосунку «Команди» (приблизно дві хвилини):

  1. Нова команда, назвіть її «Upload to YourImageShare». У її параметрах увімкніть Show in Share Sheet і дозвольте зображення та медіа.
  2. Додайте Get Contents of URL: URL https://yourimageshare.com/api/widget, метод POST, тіло запиту Form із двома полями: uploads (File) = Shortcut Input і client (Text) = ios-shortcut.
  3. Додайте Get Dictionary Value для data, а потім ще одну для src: це і є пряме посилання.
  4. Додайте Copy to Clipboard і Show Notification («Link copied»).

Без ключа завантаження анонімні та unlisted, з добовим лімітом. Додайте заголовок X-API-Key зі своїм ключем лише для завантаження (Мій акаунт > API), щоб завантажувати у свій акаунт. У відповіді також є delete_url, якщо ви хочете зберегти посилання для видалення.

PicGo і PicList

PicGo і PicList завантажують вставлені чи перетягнуті зображення для редакторів Markdown (Typora, VS Code, Obsidian, Joplin) і вставляють посилання у ваш текст. Наш плагін робить YourImageShare одним із їхніх фотохостингів.

  • У PicGo або PicList: Plugins, знайдіть yourimageshare, встановіть, потім виберіть YourImageShare як засіб завантаження. Командний рядок: picgo install yourimageshare
  • Або завантажте плагін і імпортуйте його як локальний плагін (спершу розпакуйте)
  • Налаштування: ключ лише для завантаження (необов'язково: порожній = анонімні unlisted-завантаження), видимість і те, чи повертати пряме посилання на зображення (для Markdown), чи посилання на сторінку
  • Посилання, яке він повертає, продовжує працювати, коли великі зображення пізніше оптимізуються до WebP

Завантажити плагін для PicGo

Telegram-бот

Отримайте посилання на фото, відео чи GIF, не виходячи з Telegram. Надішліть їх боту @YourImageShare_bot, і посилання одразу повернеться: без акаунта й без API-ключа. Бот завантажує через той самий ендпоінт /api, описаний вище.

  • Надішліть фото, відео, GIF або файл із зображенням чи відео; альбом до 10 файлів повертається в одній відповіді
  • У групі дайте команду /link у відповідь на фото чи відео, і бот опублікує його посилання для всіх
  • /autodelete робить так, що ваші наступні завантаження самі видаляються через 1 годину, 1 день, 1 тиждень або 30 днів
  • У кожного результату є кнопка «Видалити», яка працює лише для того, хто завантажив файл
  • Посилання unlisted: файл бачать лише ті, хто має посилання
  • Бот відповідає мовою вашого Telegram, якщо сайт доступний цією мовою

Зберігайте повну якість: Telegram стискає фото, надіслані звичайним способом. Надсилайте їх як файл (📎 → Файл), і завантажиться оригінал. Telegram дозволяє ботам отримувати файли до 20 MB, тож більші файли завантажуйте на сайті.

Відкрити @YourImageShare_bot у Telegram

Discord-бот

Перетворюйте будь-яке зображення, GIF чи відео в Discord на постійне посилання. Власні посилання Discord на вкладення за якийсь час перестають працювати, а посилання YourImageShare працюють. Акаунт і API-ключ не потрібні. Бот завантажує через той самий ендпоінт /api, описаний вище.

  • /upload з файлом: необов'язкове автовидалення через 1, 7 або 30 днів і only_me, щоб показати посилання лише вам
  • Клацніть повідомлення правою кнопкою → Apps → Rehost on YourImageShare, щоб перезавантажити з нього до 6 зображень чи відео в одній відповіді
  • Додайте його на сервер або у власний акаунт, щоб користуватися в будь-якому чаті чи особистих повідомленнях
  • У кожного результату є кнопка «Видалити», яка працює лише для того, хто завантажив файл
  • Посилання unlisted: файл бачать лише ті, хто має посилання

Додати YourImageShare в Discord

GitHub Action для Playwright і Cypress

Коли наскрізні тести падають у pull request, дізнайтеся чому, не завантажуючи zip-архіви артефактів. Ця дія завантажує скриншоти збоїв і візуальні відмінності та показує їх як зображення в одному коментарі до pull request, який оновлюється під час кожного запуску.

  • Працює з Playwright і Cypress, а також сама визначає, який із них використовує проєкт
  • Невдалі візуальні порівняння відображаються як Expected, Actual і Diff із посиланням на слайдер «до/після» (toHaveScreenshot у Playwright; для Cypress це плагіни cypress-image-diff-js і cypress-visual-regression)
  • Коментар змінюється на «all tests passed», щойно тести виправлено; той самий звіт потрапляє до підсумку завдання
  • Скриншоти приватні (лише файли зображень, без сторінки) і за замовчуванням видаляються через 30 днів
  • Їй потрібен ваш ключ лише для завантаження як секрет репозиторію YOURIMAGESHARE_API_KEY; ця дія ніколи не ламає вашу збірку
- uses: yourimageshare/playwright-pr-screenshots@v1
  if: always()
  with:
    api-key: ${{ secrets.YOURIMAGESHARE_API_KEY }}

Інструкція з налаштування на GitHub

Проєкти спільноти

Деякі з найкращих інтеграцій YourImageShare створюють ті, хто ним користується. Ці проєкти зробили учасники спільноти за допомогою публічного API, описаного вище. Їх підтримують самі автори, тож із запитаннями чи повідомленнями про помилки звертайтеся до автора через сторінку проєкту.

  • YourImageShare Uploads for FlatBB - плагін для форуму FlatBB від madromas (MadWay Inc.).
    • Додає кнопку завантаження в редактор повідомлень FlatBB: виберіть одне чи кілька зображень або відео, і Markdown вставиться в позицію курсора
    • Вставляє кожне завантаження як мініатюру з посиланням, зображення повного розміру або звичайне посилання (відео як посилання)
    • Завантаження йдуть через сервер вашого форуму з ключем API лише для завантаження, тож ключ ніколи не потрапляє в браузери відвідувачів
    • Файли розміщуються на YourImageShare, а не на диску вашого форуму, з вибраною вами видимістю за замовчуванням (private, unlisted або public)
    • Працює разом із власним засобом завантаження FlatBB, з окремим обмеженням розміру файлу

    Код на GitHub · Сторінка в FlatBB Marketplace

Дякуємо

Щиро дякуємо всім, хто створює щось із YourImageShare і ділиться своєю роботою з іншими. Проєкти спільноти приносять YourImageShare туди, куди ми б самі ніколи не дісталися. Створили щось за допомогою API? Розкажіть нам про це, і ми з радістю додамо це сюди.

З блогу

Готові спробувати?

Отримати API-ключ →