Статьи
У запроса один источник. Это публичный адрес, HTML до 500 000 байт или Markdown до 200 000 байт. Обратно вы можете получить изображение, PDF, HTML или Markdown.
Отправьте html или markdown и не передавайте url. Если источников больше одного, запрос отклоняется. Markdown поддерживает заголовки, абзацы, списки с пометкой - или *, ссылки, полужирный, курсив, встроенный код и ограждённые блоки кода. Документ отрисовывается на простой странице, затем снимается с теми же полями окна, устройства и формата, что и адрес. HTML, который вы отправляете, и есть документ, до 500 000 байт.
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 символов. Только один источник. |
Нет. В запросе должно быть что-то одно: url, html или markdown. Дополнительный CSS относится к styles, дополнительный JavaScript — к scripts.
Нет. format MD записывает название страницы как заголовок, затем видимый текст, до 200 000 символов. format HTML записывает отрисованный документ.
Да. create_screenshot на POST /mcp принимает те же поля, включая html и markdown. Статья про MCP разбирает ожидание и файл, который инструмент может вернуть.
Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.