ForHosting KIT · Immagini e foto

Ritaglio automatico

Il ritaglio automatico individua il soggetto principale di una foto — un volto, un prodotto, il punto “importante” — e ritaglia intorno a quello alla misura o al rapporto che scegli. Utile quando devi portare tante immagini a un formato unico senza controllarne una per una e senza tagliare la parte che conta.

● Stabileper richiesta + per immagine$0.002

Esegui — $0.002 + $0.005/immagine Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Esegui online

Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.

Come capisce dove tagliare

Lo strumento analizza l'immagine e stima dove sta il soggetto: la faccia in un ritratto, l'oggetto in una foto prodotto, l'area con più dettaglio in un paesaggio. Poi centra il ritaglio lì, così passando da orizzontale a quadrato non ti ritrovi la testa mozzata o il prodotto tagliato a metà. Non è magia: su immagini confuse o con più soggetti può scegliere diversamente da te. Per questo resta l'anteprima, e se serve puoi passare al ritaglio manuale sulla stessa foto.

Quando conviene rispetto al taglio a mano

Il ritaglio automatico brilla sui numeri: cento foto prodotto da portare tutte a quadrato, gli scatti degli annunci, le immagini di un catalogo che arrivano inquadrate in mille modi. A mano ci metteresti ore; qui imposti il formato una volta e le foto si tagliano da sole, ciascuna centrata sul suo soggetto. Per il singolo scatto d'autore, dove l'inquadratura è una scelta creativa, il ritaglio manuale resta più adatto: lì decidi tu al pixel.

Da questa pagina o dentro il tuo flusso

Lo usi subito da qui caricando le immagini, oppure lo richiami via API per farlo scattare in automatico su ogni foto che entra nel tuo gestionale o nel tuo e-commerce. A breve arrivano anche l'app, l'email e Telegram come canali aggiuntivi. Il motore di rilevamento serve solo a inquadrare: individua il soggetto per ritagliare, non riconosce né identifica le persone.

Casi d'uso

Cento schede prodotto tutte quadrate

Il marketplace vuole foto 1:1 ma i tuoi scatti sono in formati diversi. Il ritaglio automatico centra ogni prodotto e ti restituisce l'intero catalogo in quadrato, pronto da caricare.

Avatar da foto qualsiasi

Devi ricavare foto profilo dal personale di un'azienda. Ogni ritratto viene ritagliato sul volto in formato quadrato, senza che tu debba inquadrare a mano una per una.

Copertine social da immagini verticali

Le foto dell'evento sono verticali, ma per Facebook servono orizzontali. Lo smart crop taglia in 16:9 tenendo al centro le persone, e le copertine escono già impaginate.

Domande frequenti

In cosa è diverso dal ritaglio normale?

Nel ritaglio normale scegli tu l'area; qui è lo strumento a trovare il soggetto e a centrare il taglio da solo. È pensato per lavorare su molte foto insieme, quando controllarle a una a una non è pratico.

E se sbaglia a inquadrare?

Può capitare su immagini con più soggetti o poco definite. C'è sempre l'anteprima, e sulla stessa foto puoi passare al ritaglio manuale e sistemare il taglio al pixel.

Riconosce chi c'è nella foto?

No. Il rilevamento serve solo a capire dove ritagliare: individua l'area del soggetto, non identifica le persone e non crea profili biometrici.

Posso scegliere io il formato d'uscita?

Sì: imposti il rapporto o i pixel — quadrato, 4:5, 16:9 — e il ritaglio automatico si adatta a quella misura su ogni immagine.

Quanto costa?

$0.005 per immagine più $0.002 a richiesta, senza abbonamento. Su un lotto grande il conto è semplicemente il numero di foto per quel prezzo.

Le immagini vengono conservate?

No. Vengono elaborate per il ritaglio e poi cancellate; non restano sui nostri server e non le usiamo per altro.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/image/smart-crop

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

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)

Esempio di richiesta

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

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.smart_crop",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

per immagine$0.005

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Limiti

`max_mb`	15
`max_megapixels`	12

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →