Перейти до основного вмісту
PPDF123

Додавання зображення до PDF

Накласти зображення розміщує картинку PNG, JPEG чи SVG на PDF у позиції x та y, яку ви вкажете, у пунктах від лівого нижнього кута. Без вашого вибору «кожна сторінка» штампується лише перша сторінка.

Перетягніть файли сюди або натисніть, щоб вибрати

Формати: PDF · до 500.0 MB на файл · до 20 файлів за раз

Файл також можна вставити через Ctrl/Cmd+V або з меню буфера обміну.

«Накласти зображення» кладе `imageFile` у координати `(x,y)` у пунктах PDF (початок — лівий нижній кут). Растрові файли стають Flate XObject. SVG друкується через WeasyPrint і імпортується як Form. `everyPage=true` ставить зображення на всі сторінки; інакше лише на першу.

Завантаження має ім’я `overlayed_{base}.pdf`. Файли, захищені паролем, на цій сторінці розблоковуються за вас, щойно ви введете пароль; виклики через API спочатку виконують «Зняти пароль».

Поля масштабу немає; розмір — це власна ширина/висота зображення в матриці `cm`. Непрозорість не є параметром.

Для текстової позначки скористайтеся «Поставити штамп». Якщо шаром має бути інший PDF, скористайтеся «Накласти PDF».

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

Розміщення задається однією точкою прив’язки. `x` і `y` дають лівий нижній кут зображення в пунктах від лівого нижнього кута сторінки, а зображення тягнеться звідти праворуч і вгору. Розмір обираєте не ви: растр розміщується з одним пунктом PDF на піксель, тож PNG 300 на 100 пікселів займає 300 на 100 пунктів, приблизно 4,2 на 1,4 дюйма. Сторінка формату Letter має 612 на 792 пункти, тож усе, що помітно ширше, вийде за межі сторінки. Змініть розмір картинки до потрібного перед вивантаженням.

Растрові зображення (PNG і JPEG) декодуються й зберігаються заново як 8-бітний RGB. Прозорість не зберігається, тож PNG із прозорим тлом може показати суцільний блок замість прозорої ділянки. Якщо вам потрібен логотип, що зливається зі сторінкою, спершу експортуйте його на білому чи відповідному тлі або розмістіть лише на білій ділянці.

`everyPage=false` ставить зображення лише на сторінку 1; `everyPage=true` повторює його в тих самих координатах на кожній сторінці. Сторінки різних розмірів отримують ту саму точку прив’язки, тож у змішаному файлі позначка може опинитися в різних місцях візуально. Вибрати лише сторінки 2 і 5 не можна; якщо це потрібно, розріжте файл, поставте зображення на потрібну частину й об’єднайте назад.

Якщо вивантаження не вдається, звичайна причина — файл, який не є зображенням, зрозумілим декодеру (повертається повідомлення про непідтримуваний тип файлу), або відсутній `imageFile`. Експортуйте картинку заново як PNG чи JPEG і спробуйте ще раз.

Що вміє

  • Растровий XObject або SVG через WeasyPrint як Form
  • `x`,`y` у пунктах; перша сторінка або кожна
  • Немає керування непрозорістю чи масштабом
  • Анонімний API: /api/v1/misc/add-image

Коли брати цей інструмент

  • Поставити PNG-логотип на першу сторінку
  • Повторити позначку у фіксованій точці на кожній сторінці
  • Пропустити SVG через WeasyPrint, коли вас влаштовує точність друку
  • Додати зображення відсканованого підпису на рядок підпису односторінкової угоди
  • Поставити печатку компанії в колонтитул кожної сторінки звіту з однаковим розміром сторінок

Як додати зображення до PDF?

  1. Вивантажте PDF і зображення (PNG, JPEG або SVG).
  2. Задайте x і y у пунктах від лівого нижнього кута.
  3. Оберіть лише першу сторінку або кожну.
  4. Завантажте overlayed_*.pdf і перевірте точку прив’язки.

Обмеження і межі

  • Немає полів масштабу/непрозорості
  • Лише одна точка прив’язки: вибору сторінок немає, окрім першої або кожної
  • Не прибирає й не приховує вміст під зображенням
  • Великі растри стають великим розміщенням у PDF
  • Прозорі ділянки PNG не зберігаються: зображення перетворюються на RGB, тож прозорі пікселі набувають кольору, що зберігається під ними, найчастіше чорного
  • Файли, захищені паролем, потребують пароля; виклики через API спочатку виконують «Зняти пароль»
  • Обмеження завантаження на цьому сайті: 500 МБ на файл; якщо файл більший за приблизно 95 МБ, він надсилається частинами. Тіло одного прямого запиту до API — не більше 100 МБ.

Приклади

  • x=0 y=0 ставить лівий низ зображення в лівий низ сторінки
  • everyPage=false лишає сторінки з 2-ї без змін
  • Логотип PNG 200 на 80 пікселів з x=400, y=20 і everyPage=true опиняється в правому нижньому куті кожної сторінки формату Letter, завширшки 200 пунктів, а завантаження для вхідного report.pdf має ім’я overlayed_report.pdf
  • Фото завширшки 1800 пікселів, поставлене в x=0, y=0, виходить далеко за межі сторінки завширшки 612 пунктів, що показує: розмір розміщення відповідає пікселям; спершу зменшіть картинку приблизно до 150 пікселів завширшки

Приватність цього інструмента

Файли надсилаються через HTTPS, обробляються в оперативній пам’яті або в короткочасному тимчасовому каталозі на наших серверах і видаляються, щойно результат готовий. Копій для подальшого перегляду, навчання моделей чи рекламних профілів ми не зберігаємо. Строки зберігання та відомості про файли cookie AdSense наведені в Політиці конфіденційності.

Часті запитання

Чому логотип величезний?
Матриця cm трактує ширину й висоту в пікселях як одиниці PDF. PNG на 2000px має 2000 пунктів завширшки.
Чи y рахується зверху?
Ні. У типовому просторі PDF початок координат — лівий нижній кут.
Чи можна задати непрозорість?
Ні. Накладання — це непрозорі оператори малювання.
Чи лишається SVG вектором?
SVG друкується WeasyPrint у односторінковий PDF, а потім кладеться як form. Очікуйте друк, а не редагований SVG.
Як зробити зображення меншим?
Змініть його розмір перед вивантаженням. Поля масштабу немає, а розмір розміщення відповідає піксельним розмірам зображення, тож логотип 150 на 50 пікселів займе 150 на 50 пунктів.
Чому мій прозорий PNG показує чорний чи суцільний прямокутник?
Зображення перетворюються на RGB, а альфа-канал відкидається. Експортуйте логотип заново на білому тлі або розмістіть його на білій частині сторінки.
Чи можна поставити зображення лише на сторінку 3?
Безпосередньо ні. Вибір такий: сторінка 1 або кожна сторінка. Виділіть потрібну сторінку, додайте на неї зображення, а потім об’єднайте файли назад по порядку.
Чи можна цим сховати текст на сторінці?
Небезпечно так робити. Текст лишається у файлі під зображенням і його все ще можна виділити чи витягти. Якщо вміст треба прибрати, скористайтеся «Замалювання».
Зображення поза сторінкою. Як знайти правильні координати?
Міряйте від лівого нижнього кута в пунктах. На сторінці Letter це 612 на 792, тож x=450 і y=40 ставить лівий нижній кут логотипа поблизу правого низу за умови, що логотип вміщується в 162 пункти ширини, які лишаються.

Востаннє оновлено:

Виклик із коду

Кожен інструмент на сайті - звичайний REST-інтерфейс. Для анонімної роботи не потрібні обліковий запис чи ключ API. І для браузера, і для розробників, і для програмних агентів.

curl -X POST "https://pdf123.xyz/api/v1/misc/add-image" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "x=0" \
  -F "y=0" \
  -F "everyPage=false" \
  -o output.pdf

Також є як MCP-інструмент для клієнтів із Model Context Protocol (JSON-RPC 2.0 через POST /mcp). Повний довідник API

Використати через ШІ-агента

Скіл

З цим скілом Claude Code, Codex, Cursor та інші ШІ-агенти зможуть виконати «Накласти зображення» замість вас: /skills/pdf123-add-image.md

Усі скіли для агентів

Файли потрібні лише для цієї обробки й потім стираються самі.