POST AI agent ready /v1/placeholder

API изображений-заполнителей — бесплатные пользовательские размеры

Создавайте изображения-заполнители для каркасов, прототипов и разработки. Укажите точные размеры, наложите текст, выберите цвета фона и переднего плана, а также выберите вывод в формате SVG или PNG. Полезно во время разработки интерфейса, когда конечные ресурсы недоступны.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/placeholder \
  -H "Content-Type: application/json" \
  -d '{"width":600,"height":400,"text":"Hero Banner","bg_color":"#f1f5f9","text_color":"#0f172a"}'

When to use this API

Каркасное прототипирование

Перетащите изображения-заполнители в файлы экспорта Figma или HTML-прототипы, чтобы заинтересованные стороны могли проверить макет и интервалы до того, как фотография или иллюстрация будут готовы.

Размещение контента CMS

Заполните промежуточную CMS заполнителями правильного размера для каждого поля изображения. Редакторы контента видят точное место, которое будет занимать каждая фотография, прежде чем загружать окончательные ресурсы.

Автоматизированные испытательные приспособления

Создавайте предсказуемые изображения-заполнители в интеграционных тестах для потоков загрузки изображений. Укажите размеры и тип файла, не полагаясь на статические файлы креплений.

Frequently asked questions

Каков максимальный размер изображения?

Вы можете запросить изображения размером до 4000х4000 пикселей. Для больших размеров рассмотрите возможность создания SVG и его растеризации на собственном сервере, чтобы избежать большой полезной нагрузки.

Могу ли я использовать собственные шрифты для наложения текста?

API отображает текст шрифтом без засечек по умолчанию. Поддержка пользовательских шрифтов недоступна. Если вам нужна конкретная гарнитура, скачайте SVG и обновите атрибут font-family в разметке.

Какой текст появится, если я оставлю текстовый параметр пустым?

На изображении отображаются его размеры, например «600х400». Это позволяет легко проверить размеры во время разработки.

Что выбрать: SVG или PNG?

SVG имеет меньший размер файла и масштабируется до любого разрешения без размытия. PNG лучше использовать, когда вам нужен растровый файл для загрузки в системы, не поддерживающие SVG, например в некоторые почтовые клиенты.

Могу ли я установить прозрачный фон?

Прозрачность не поддерживается. Для получения аналогичного эффекта укажите цвет фона, соответствующий фону вашей страницы.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.