ForHosting KIT · Imagens

Corte inteligente de imagem

O corte inteligente analisa a imagem, encontra a região mais importante — um rosto, o produto, o centro visual da cena — e recorta na proporção que você pedir, sem decapitar ninguém. É a opção certa para gerar quadrados e banners a partir de fotos variadas, direto do seu sistema, sem ajuste manual.

● Estávelpor imagemUS$ 0,002

Executar — US$ 0,002 + US$ 0,005/imagem Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

O que muda em relação ao corte comum

No corte tradicional você informa as coordenadas exatas do recorte; no corte inteligente, informa só a proporção ou o tamanho final, e a análise da imagem decide onde recortar. O algoritmo identifica a região de maior interesse — rostos, o objeto principal, a área de maior contraste — e centraliza o recorte nela. Na prática, é o que permite transformar mil fotos diferentes em mil quadrados aproveitáveis sem que alguém revise uma por uma.

Onde o recorte automático acerta e onde exige atenção

Retratos, fotos de produto sobre fundo neutro e cenas com um assunto claro são o terreno ideal: o recorte cai no lugar certo quase sempre. Cenas com dois focos distantes — duas pessoas nas pontas da foto, por exemplo — obrigam a escolher um lado, e o resultado merece conferência. Para esses casos, vale gerar o recorte automático como proposta e manter o corte manual por coordenadas como plano B no seu fluxo.

Formatos aceitos e fluxo de trabalho

Entram JPG, PNG, WebP e os demais formatos comuns, com até 15 MB e 12 megapixels por arquivo. A chamada é assíncrona: você envia a imagem com a proporção desejada, recebe um task_id e busca o resultado quando estiver pronto. Esse desenho encaixa bem em filas de processamento — o upload do usuário entra, o recorte acontece em segundo plano e a versão final aparece no sistema sem travar nada.

Preço publicado, conta simples

Cada chamada custa US$ 0,002, mais US$ 0,005 por imagem processada. Recortar 500 fotos de produto, uma por chamada, sai por US$ 3,50 — sem assinatura, sem franquia mínima e sem surpresa no fim do mês. O preço está publicado na página e vale para qualquer volume: quem recorta dez imagens paga por dez, quem recorta dez mil paga por dez mil. A compra é direta, sem cadastro no caminho.

Casos de uso

Vitrine quadrada sem cortar a modelo

A loja de roupas de Márcia Regina Oliveira, em Curitiba, recebe fotos de look sempre verticais. O corte inteligente gera o quadrado da vitrine mantendo o rosto da modelo no enquadramento — antes, o corte fixo no centro cortava a cabeça em metade das fotos.

Destaques de imóveis no portal

O portal imobiliário que a TecnoSul Soluções Digitais ME desenvolve gera cartões de destaque em 16:9 a partir das fotos enviadas pelos corretores. O recorte automático prioriza a fachada ou o ambiente principal, não o teto nem o chão.

Avatar a partir de qualquer foto

Rafael Almeida Costa mantém um app de agendamento em Recife onde cada profissional envia a foto que quiser. O corte inteligente transforma tudo em avatar quadrado com o rosto centralizado, sem pedir que o usuário ajuste nada.

Perguntas frequentes

Como a ferramenta decide o que fica no recorte?

A imagem é analisada para localizar a região de maior interesse visual — quando há um rosto ou um objeto principal, ele tende a pesar mais — e o recorte é centralizado nela, respeitando a proporção que você pediu.

E se a foto tiver duas pessoas em cantos opostos?

O recorte escolhe a região dominante, então uma das duas pode ficar de fora. Para fotos de grupo em proporções muito apertadas, o ideal é revisar o resultado ou usar o corte manual por coordenadas.

Posso gerar mais de uma proporção da mesma imagem?

Sim: basta pedir um recorte por proporção — quadrado para a vitrine, 16:9 para o banner, 4:5 para a rede social. Cada recorte é uma imagem processada e é cobrado como tal.

Qual é o preço para um catálogo grande?

US$ 0,002 por chamada mais US$ 0,005 por imagem. Um catálogo de 2.000 fotos, uma imagem por chamada, custa US$ 14 no total, pago por uso e sem mensalidade.

As fotos que eu enviar podem ser usadas para outra coisa?

Não: o arquivo entra, é processado e o resultado fica disponível para download pela tarefa. Nada é publicado nem reaproveitado — o que importa especialmente sob a LGPD quando as fotos mostram pessoas.

Detectar rostos para recortar não fere a LGPD?

A detecção aqui serve só para posicionar o enquadramento: ninguém é identificado e nenhum padrão biométrico é guardado. O rosto funciona como referência visual do recorte, nada além disso.

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/smart-crop

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/smart-crop \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/smart-crop",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/smart-crop", 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

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Exemplo de resposta

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

por imagemUS$ 0,005

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.

Ver a documentação completa do KIT →