Наложение изображения на 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?
- Загрузите PDF и изображение (PNG, JPEG или SVG).
- Задайте x и y в пунктах от левого нижнего угла.
- Выберите только первую страницу или каждую.
- Скачайте 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
Файлы нужны только для этой обработки и потом удаляются.