Conversor de megapixels

Nomes de unidade desconhecidos falham com um erro invalid_input claro em vez de fatores silenciosos errados. Fotógrafos que comparam megapixels do corpo a quadros reais de 4000 por 3000, equipes de produto que dimensionam pipelines de imagem, educadores que ensinam fatores SI mega e clientes de API que normalizam campos mistos de resolução compartilham o mesmo caminho determinístico.

Quais unidades de resolução são suportadas e como a conversão funciona

Quando o destino é dimensions, largura e altura são recuperadas a partir do total e de uma relação de aspecto: a largura é a raiz quadrada do total vezes aspect_w sobre aspect_h, e a altura é o total dividido pela largura, com quadro dezesseis por nove por padrão se você omitir aspect_w e aspect_h. Aliases comuns são aceitos sem distinção de maiúsculas: mp, mpx e megapixel para megapixels; px, pixel count e total pixels para pixels; kp e kpx para kilopixels; gp e gpx para gigapixels; e wxh, width x height e resolution para dimensions. Se o nome não estiver nessa lista, o solver rejeita o pedido com invalid_input nomeando o campo incorreto e listando as unidades suportadas, para que os clientes nunca adivinhem se um erro de digitação gerou um número errado. Zeros e valores negativos são rejeitados porque contagens de pixels e classificações em megapixels não são quantidades com sinal; a magnitude absoluta deve permanecer dentro do limite publicado de um trilhão para que produtos intermediários permaneçam finitos em precisão IEEE de dupla no Worker e no navegador.

Como chamar a API e ler a resposta

Integre isso a ferramentas de comparação de câmeras, pipelines de ativos de mídia, fichas educativas ou jobs em lote que já tenham uma leitura de resolução e só precisem de uma segunda representação para exibição ou armazenamento sem distribuir tabelas de conversão em cada binário de aplicativo. Envie um corpo JSON com a unidade de destino em to (aliases to_unit, unit_to e target) e uma leitura escalar ou um par largura por altura. No modo escalar forneça value (aliases amount, quantity, n e mp) e opcionalmente from (aliases from_unit, unit_from e source); quando from é omitido e value está presente, a origem padrão é megapixels. No modo dimensões forneça width e height positivos (aliases width_px, w, w_px e height_px, h, h_px); from pode ser dimensions ou omitido. Quando to é dimensions, aspect_w e aspect_h opcionais (padrão dezesseis e nove) controlam a forma do quadro recuperado. Value, width, height e as partes de aspecto devem ser números finitos positivos ou strings numéricas estritas dentro do limite absoluto de um trilhão. Em caso de sucesso a resposta ecoa um value arredondado, rótulos canônicos from e to, result como magnitude principal convertida, total_pixels, megapixels, kilopixels e gigapixels em cada pedido, unit como rótulo de destino, formula e message como resumos em inglês da lógica, steps como linhas de substituição ordenadas e supported_units com os cinco identificadores canônicos. Quando há dimensões de entrada ou saída, width, height, aspect_w e aspect_h também aparecem. Validação falha—campos ausentes, números não finitos, valores não positivos, valores fora dos limites absolutos ou nome de unidade desconhecido—retorna invalid_input e nunca é cobrada. O preço é um valor fixo de US$ 0,002 por pedido bem-sucedido com unidade item.

Dicas práticas, limites e quando usar esta landing

Prefira enviar números puros para value, width e height quando você controla o cliente; strings numéricas só são aceitas se corresponderem a um padrão numérico finito estrito sem símbolos de moeda nem separadores de milhar. Normalize rótulos de exibição no seu lado se precisar de grafias locais: esta API sempre devolve os tokens canônicos curtos megapixels, pixels, kilopixels, gigapixels e dimensions para que testes automatizados permaneçam estáveis. Tarefas com falha que retornam invalid_input não consomem saldo pré-pago, o que mantém baratos scripts exploratórios quando clientes testam de propósito nomes de unidade desconhecidos.