Перейти к основному содержимому
PPDF123

Наложение изображения на PDF

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

Перетащите файлы сюда или нажмите, чтобы выбрать

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

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

«Наложить изображение» кладёт `imageFile` в PDF в точке `(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-логотип на страницу 1
  • Повторить метку в фиксированной точке на каждой странице
  • Отправить 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

Все скиллы для агентов

Файлы нужны только для этой обработки и потом удаляются.