Статьи

Выбрать формат файла

format выбирает файл. Если его не задать, съёмка будет в PNG. JPEG сохраняется как JPG. MARKDOWN сохраняется как MD. Качество, новый размер и прозрачный фон действуют только у тех форматов изображений, которые это умеют.

Статьи по API скриншотов

Шесть файлов

PNG, JPG и WebP — изображения. PDF — документ, и для него есть поля бумаги. HTML — отрисованный документ. MD — название страницы как заголовок и следом видимый текст, не больше 200 000 символов. Живой URL встраивания принимает PNG, JPG, WebP и PDF. Встраивание по id принимает готовые PNG, JPG или WebP. Подписанный URL готового скриншота ведёт на тот формат, который вы сохранили. Срок жизни этого URL по умолчанию — пять минут.

Качество, размер и прозрачный PNG

image_quality задаётся от 0 до 100 и применяется к JPG и WebP. Для PNG он игнорируется. image_width и image_height меняют размер PNG, JPG или WebP, каждое значение от 1 до 10 000. Для PDF, HTML и Markdown они отклоняются. omit_background поддерживается только у PNG. Фон убирается, и изображение можно положить на другой цвет. Сначала задайте format равным PNG, потом включайте этот параметр.

Один формат на задание

Один вызов создания хранит один формат. Элемент пакета может выбрать свой. Фрагментам нужны PNG, JPG или WebP. Попадание в кэш сверяет формат вместе с адресом и параметрами, поэтому PNG и WebP одной страницы — это две съёмки. POST возвращает 202 для нового задания и 200, когда берётся готовый снимок из кэша. Запросите id, чтобы получить image_url, или задайте callback_url и прочитайте его из вебхука.

Поля

Имена, которые принимает этот запрос
format PNG, JPG, JPEG, WEBP, PDF, HTML, MD или MARKDOWN. По умолчанию PNG. JPEG сохраняется как JPG.
image_quality От 0 до 100 для JPG и WebP. Для PNG игнорируется.
image_width Новая ширина PNG, JPG или WebP, от 1 до 10 000.
image_height Новая высота PNG, JPG или WebP, от 1 до 10 000.
omit_background Прозрачный фон. Только PNG.

Вопросы

Что взять для резкого снимка продукта?

PNG. Это значение по умолчанию. Берите JPG или WebP с image_quality, если размер файла важнее картинки без потерь.

Почему omit_background отклонили?

Формат был не PNG. Задайте format равным PNG. На JPG и WebP качество и прозрачный фон вместе не ставятся.

Один запрос может вернуть и PNG, и PDF?

Нет. Отправьте два создания или один пакетный массив из двух элементов с двумя значениями format.

Другие статьи

Альтернативы, которые используют эти поля

Сравнения

Отправьте первый адрес

Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.