Статьи
format выбирает файл. Если его не задать, съёмка будет в PNG. JPEG сохраняется как JPG. MARKDOWN сохраняется как MD. Качество, новый размер и прозрачный фон действуют только у тех форматов изображений, которые это умеют.
PNG, JPG и WebP — изображения. PDF — документ, и для него есть поля бумаги. HTML — отрисованный документ. MD — название страницы как заголовок и следом видимый текст, не больше 200 000 символов. Живой URL встраивания принимает PNG, JPG, WebP и PDF. Встраивание по id принимает готовые PNG, JPG или WebP. Подписанный URL готового скриншота ведёт на тот формат, который вы сохранили. Срок жизни этого URL по умолчанию — пять минут.
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, если размер файла важнее картинки без потерь.
Формат был не PNG. Задайте format равным PNG. На JPG и WebP качество и прозрачный фон вместе не ставятся.
Нет. Отправьте два создания или один пакетный массив из двух элементов с двумя значениями format.
Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.