Статьи

Скриншот HTML или Markdown

У запроса один источник. Это публичный адрес, HTML до 500 000 байт или Markdown до 200 000 байт. Обратно вы можете получить изображение, PDF, HTML или Markdown.

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

HTML или Markdown как страница

Отправьте html или markdown и не передавайте url. Если источников больше одного, запрос отклоняется. Markdown поддерживает заголовки, абзацы, списки с пометкой - или *, ссылки, полужирный, курсив, встроенный код и ограждённые блоки кода. Документ отрисовывается на простой странице, затем снимается с теми же полями окна, устройства и формата, что и адрес. HTML, который вы отправляете, и есть документ, до 500 000 байт.

HTML или Markdown как файл

format HTML сохраняет отрисованный документ. format MD или псевдоним MARKDOWN сохраняет файл Markdown: название страницы как заголовок, затем видимый текст, не больше 200 000 символов. JPEG сохраняется как JPG. Эти форматы — файлы, а не метаданные. metadata_content тоже может приложить документ или видимый текст к JSON. Об этом статья про метаданные.

Каким может быть адрес

url или callback_url должен быть абсолютным адресом http или https в публичном интернете, не длиннее 2 048 символов. Localhost, имена с окончанием .local и частные, loopback или link-local адреса отклоняются. HTML и Markdown в теле не открывают хост, поэтому так отрисовывают документ, который не опубликован.

Поля

Имена, которые принимает этот запрос
html Документ для отрисовки, до 500 000 байт. Не отправляйте вместе с ним url или markdown.
markdown Markdown для отрисовки, до 200 000 байт. Заголовки, списки, ссылки, выделение и ограждённый код.
format По умолчанию PNG. HTML возвращает документ. MD или MARKDOWN возвращает заголовок и видимый текст.
url Публичный адрес http или https, до 2 048 символов. Только один источник.

Вопросы

Можно ли отправить адрес и HTML вместе?

Нет. В запросе должно быть что-то одно: url, html или markdown. Дополнительный CSS относится к styles, дополнительный JavaScript — к scripts.

Файл Markdown — это полная конвертация каждого HTML-тега?

Нет. format MD записывает название страницы как заголовок, затем видимый текст, до 200 000 символов. format HTML записывает отрисованный документ.

Может ли ассистент отправить тот же HTML?

Да. create_screenshot на POST /mcp принимает те же поля, включая html и markdown. Статья про MCP разбирает ожидание и файл, который инструмент может вернуть.

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

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

Сравнения

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

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