ForHosting KIT · Imagens

Calcular correção EXIF

Descubra a correção exata para qualquer valor de orientação EXIF de 1 a 8: a orientação 6 pede uma rotação de 90 graus no sentido horário e nenhum espelhamento, e os valores espelhados também recebem o espelhamento certo. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Orientação: 6

Você obtém

Rotação (graus): 90
Ordem das operações: flip_then_rotate

A tag de orientação EXIF informa ao software como transformar os pixels armazenados para que a imagem apareça na posição correta. Esta capacidade converte qualquer valor válido de 1 a 8 em uma instrução pronta para implementação: rotação no sentido horário, indicadores de espelhamento horizontal ou vertical e ordem de aplicação. Ela abrange rotações comuns de câmeras e também os casos espelhados que costumam ser implementados de forma incorreta. Você pode usar o resultado em pipelines de imagem, serviços de miniaturas, validadores de uploads ou ferramentas de inspeção de metadados sem manter uma tabela própria.

Por que uma foto correta pode armazenar pixels deitados

Muitas câmeras e celulares evitam reorganizar todos os pixels quando o aparelho é girado. Em vez disso, salvam a grade capturada na orientação mais conveniente para o sensor e gravam uma tag de orientação EXIF que informa ao visualizador como apresentá-la. Um software que respeita a tag mostra a foto corretamente; outro que a ignora pode exibir o mesmo arquivo de lado, de cabeça para baixo ou espelhado.

A tag possui oito valores definidos, e não apenas quatro ângulos. Os valores 1, 3, 6 e 8 descrevem os casos normal, meia-volta e quartos de volta. Os valores 2, 4, 5 e 7 incluem reflexão; por isso, considerar apenas a rotação gera resultados errados em alguns scanners, câmeras frontais e arquivos editados.

Esta capacidade recebe o valor numérico depois da leitura dos metadados e retorna a correção exata. Ela não decodifica nem altera a imagem: fornece a instrução confiável que o seu processador pode aplicar.

Como aplicar a transformação retornada

Envie um inteiro no campo orientation. Essa ordem é importante nas orientações 5 e 7, pois reflexão e rotação não são comutativas: inverter as operações pode produzir outra orientação espelhada. O mapeamento canônico representa a orientação 4 como espelhamento horizontal seguido de 180 graus, equivalente geometricamente a um espelhamento vertical.

Usar um único eixo canônico simplifica o código posterior, enquanto o indicador vertical explícito mantém a resposta estável. A orientação 1 retorna rotação zero e nenhum espelhamento. Valores fora de 1 a 8, frações, textos numéricos, campos ausentes e outros tipos retornam erro de entrada inválida, sem adivinhação.

Onde inserir a consulta de orientação no pipeline

Use este cálculo logo depois que um analisador EXIF ler a tag Orientation e antes de redimensionar, recortar, executar OCR, detectar rostos ou gerar miniaturas. A normalização antecipada faz com que as coordenadas seguintes se refiram à exibição correta, evitando recortes na borda errada ou reconhecimento de texto em linhas giradas. Se o seu decodificador já aplica automaticamente a orientação EXIF, não execute a transformação novamente; desative esse comportamento ou use a resposta apenas para inspeção e planejamento.

Depois de transformar fisicamente os pixels, normalmente é recomendável gravar Orientation 1 ou remover a tag antiga, pois mantê-la pode levar um visualizador compatível a repetir a correção. A capacidade é determinística e não usa dados da imagem, rede nem heurísticas específicas do dispositivo, então a mesma tag sempre gera a mesma instrução. Ela também ajuda a auditar bibliotecas, especialmente com arquivos espelhados de teste que fotos comuns raramente expõem.

Casos de uso

Normalizar fotografias enviadas

Converta a tag Orientation de cada upload em uma transformação antes de gerar miniaturas, para que todos os derivados tenham pixels fisicamente corretos.

Preparar digitalizações para OCR

Corrija pixels girados ou espelhados antes de começar o reconhecimento de texto, a análise de layout e a extração por coordenadas.

Testar uma biblioteca de imagens

Compare o comportamento da biblioteca nos oito valores EXIF com um mapeamento canônico estável de rotação e espelhamento.

Perguntas frequentes

Quais valores são aceitos?

Somente valores inteiros de orientação EXIF de 1 a 8.

Esta capacidade gira a imagem?

Não. Ela retorna a transformação necessária para exibir corretamente os pixels armazenados; a sua biblioteca de imagens aplica essa transformação.

Por que são necessários espelhamentos?

Quatro orientações EXIF incluem uma reflexão. Uma rotação isolada não representa corretamente as orientações espelhadas 2, 4, 5 e 7.

Primeiro espelhar ou primeiro girar?

Primeiro espelhe, depois gire no sentido horário. A ordem importa nas orientações 5 e 7, porque um reflexo e uma rotação não dão a mesma imagem quando trocados de lugar.

E se o meu programa de fotos já corrige a orientação sozinho?

Nesse caso, não aplique a correção de novo, ou a foto acaba girada duas vezes. Desligue o ajuste automático ou use o resultado apenas para conferir o que o arquivo informa.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

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.

Endpoint

POSThttps://api.kit.forhosting.com/image/exif-orientation-fix

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

Chame do seu código

curl -X POST https://api.kit.forhosting.com/image/exif-orientation-fix \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"orientation":6}'

const res = await fetch("https://api.kit.forhosting.com/image/exif-orientation-fix", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "orientation": 6
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/exif-orientation-fix",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "orientation": 6
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/exif-orientation-fix", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"orientation":6}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"orientation":6}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/exif-orientation-fix", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "orientation": 6
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.exif_orientation_fix",
  "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.

Preço

por chamadaUS$ 0,002

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

Limites

`max_mb`	15
`max_megapixels`	12

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Como aplicar a transformação retornada

A resposta repete esse valor e retorna rotation_degrees como 0, 90, 180 ou 270, medidos no sentido horário. Ela também fornece os indicadores booleanos flip_horizontal e flip_vertical. operation_order contém flip_then_rotate; portanto, o espelhamento ativo deve ser aplicado à grade armazenada antes da rotação.

Perguntas técnicas

Em que ordem devo aplicar o espelhamento e a rotação?

Primeiro aplique o espelhamento indicado aos pixels armazenados e depois gire no sentido horário conforme rotation_degrees, como informa operation_order.

Qual é o custo pela API?

Cada solicitação API custa US$ 0,002. O cálculo também pode ser usado no executor gratuito do navegador, pois não exige upload nem acesso à rede.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Por que uma foto correta pode armazenar pixels deitados

Como aplicar a transformação retornada

Onde inserir a consulta de orientação no pipeline

Casos de uso

Normalizar fotografias enviadas

Preparar digitalizações para OCR

Testar uma biblioteca de imagens

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

Como aplicar a transformação retornada

Perguntas técnicas

obrigado