POST AI agent ready /v1/placeholder

API de imagem de espaço reservado - tamanhos personalizados gratuitos

Crie imagens de espaço reservado para wireframes, protótipos e desenvolvimento. Especifique as dimensões exatas, sobreponha o texto, escolha as cores de fundo e de primeiro plano e escolha a saída SVG ou PNG. Útil durante o desenvolvimento front-end quando os ativos finais não estão disponíveis.

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

Prototipagem de wireframe

Coloque imagens de espaço reservado nas exportações do Figma ou em protótipos HTML para que as partes interessadas possam revisar o layout e o espaçamento antes que a fotografia ou ilustração esteja pronta.

Preparação de conteúdo CMS

Preencha um CMS de teste com espaços reservados de tamanho correto para cada campo de imagem. Os editores de conteúdo veem o espaço exato que cada foto ocupará antes de enviar os recursos finais.

Dispositivos de teste automatizados

Gere imagens de espaço reservado previsíveis em testes de integração para fluxos de upload de imagens. Afirme dimensões e tipo de arquivo sem depender de arquivos de fixação estáticos.

Frequently asked questions

Qual é o tamanho máximo da imagem?

Você pode solicitar imagens de até 4000x4000 pixels. Para tamanhos maiores, considere gerar um SVG e rasterizá-lo em seu próprio servidor para evitar grandes cargas úteis.

Posso usar fontes personalizadas para a sobreposição de texto?

A API renderiza o texto em uma fonte sem serifa padrão. O suporte a fontes personalizadas não está disponível. Se você precisar de um tipo de letra específico, busque o SVG e atualize o atributo font-family na marcação.

Que texto aparece se eu deixar o parâmetro de texto vazio?

A imagem exibe suas dimensões, por exemplo “600x400”. Isso facilita a verificação rápida do dimensionamento durante o desenvolvimento.

Devo escolher SVG ou PNG?

SVG é menor em tamanho de arquivo e pode ser dimensionado para qualquer resolução sem desfoque. PNG é melhor quando você precisa de um arquivo raster para upload em sistemas que não aceitam SVG, como alguns clientes de e-mail.

Posso definir um fundo transparente?

A transparência não é suportada. Especifique uma cor de fundo que corresponda ao plano de fundo da sua página para obter um efeito semelhante.

Get your API key

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