ForHosting KIT · Imagens

Calcule tamanhos de imagem responsiva por breakpoints

Layouts responsivos costumam definir a largura de uma imagem em vários breakpoints CSS, mas o pipeline precisa das larguras reais em pixels que serão geradas.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Esta calculadora converte cada largura renderizada na largura de origem necessária usando um multiplicador de densidade e devolve uma lista ordenada e sem duplicatas. Assim, você torna explícita e reproduzível a relação entre CSS, densidade da tela e arquivos de imagem.

Converta regras de layout em pixels de origem

Comece pelos breakpoints já definidos no design ou na folha de estilos. Para cada um, informe a largura mínima da viewport em que a regra passa a valer e a largura real de exibição da imagem. Os dois valores usam pixels CSS e podem ser copiados diretamente da especificação. A calculadora ordena as linhas pelo breakpoint, mesmo que você as envie em outra ordem. Cada largura exibida é multiplicada pela densidade escolhida e o resultado é arredondado para cima até um pixel inteiro. Esse arredondamento evita que um produto fracionário gere um recurso ligeiramente menor que o necessário. A resposta mantém o mapeamento de cada regra para revisão e também apresenta uma lista separada de larguras de origem sem duplicatas. Essa lista é o conjunto prático de variantes que você deve gerar, armazenar em cache e referenciar no fluxo de imagens responsivas.

Escolha o multiplicador de densidade com critério

O multiplicador padrão é 2, uma referência útil para manter nitidez em telas comuns de alta densidade. Assim, uma imagem exibida com 480 pixels CSS precisa de uma origem com 960 pixels. Você pode selecionar outro valor entre 0.1 e 8 quando sua política de entrega tiver prioridades diferentes. O valor 1 reduz as dimensões para telas de densidade normal, enquanto 3 prepara arquivos para painéis mais densos, com maior custo de armazenamento e transferência. O mesmo multiplicador é aplicado a todos os breakpoints, preservando uma política consistente. A ferramenta não decide qual arquivo cada visitante baixa nem estima compressão ou tamanho do arquivo: ela calcula somente larguras. Use a lista resultante em um otimizador ou serviço de transformação e permita que o navegador escolha o recurso adequado por meio da marcação e das regras de mídia do componente.

Use o resultado no pipeline responsivo

A resposta contém o multiplicador aplicado, uma linha ordenada para cada breakpoint e uma lista numérica de larguras de origem únicas. As linhas ajudam você a conferir a implementação em relação ao design, pois exibem lado a lado a largura original e a calculada. A lista única facilita a automação quando duas regras exigem o mesmo arquivo. Por exemplo, duas condições podem exibir a imagem com 600 pixels CSS; usando densidade 2, você só precisa gerar uma variante de 1200 pixels. Envie cada largura única para a etapa de redimensionamento, preserve ali a proporção e utilize as URL geradas no componente. Recorte, formato, qualidade e altura devem permanecer nessa etapa posterior, pois dependem da imagem e da direção de arte. Listas vazias e breakpoints duplicados são rejeitados porque não formam uma especificação responsiva inequívoca.

Prepare variantes durante o build

Converta as especificações do componente nas larguras únicas exatas que um site estático deve gerar.

Revise a entrega do design

Confira se os arquivos fornecidos têm pixels suficientes para a densidade combinada em cada estado do layout.

Configure um CDN de imagens

Produza uma lista estável de larguras para pedidos de redimensionamento, presets ou aquecimento de cache.

Quanto custa o cálculo?

Cada cálculo pela API custa US$ 0,002.

Por que as larguras são arredondadas para cima?

Uma imagem não pode ter largura fracionária, e arredondar para baixo poderia fornecer menos pixels que a densidade solicitada.

Qual é a densidade padrão?

O multiplicador padrão é 2; uma largura exibida de 500 pixels CSS exige uma origem de 1000 pixels.

A ferramenta gera ou redimensiona imagens?

Não. Ela calcula as larguras a gerar; um processador, uma ferramenta de build ou um CDN realiza o redimensionamento.

Por que a saída inclui sizes e source_widths?

sizes preserva os mapeamentos para revisão, enquanto source_widths remove duplicatas para uma geração eficiente.

O que acontece se a lista de breakpoints estiver vazia?

A solicitação falha com um erro de entrada inválida porque pelo menos uma regra de layout é obrigatória.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/image/responsive-breakpoint-sizes

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/image/responsive-breakpoint-sizes \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"breakpoints":[{"breakpoint":0,"display_width":320},{"breakpoint":768,"display_width":720},{"breakpoint":1200,"display_width":1080}]}'
{
  "breakpoints": [
    {
      "breakpoint": 0,
      "display_width": 320
    },
    {
      "breakpoint": 768,
      "display_width": 720
    },
    {
      "breakpoint": 1200,
      "display_width": 1080
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.responsive_breakpoint_sizes",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_mb15
max_megapixels12
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →