ForHosting KIT · Video

Crea la miniatura di un video

Estragga un fotogramma dal secondo esatto che indica e lo usi come copertina, così il video smette di accogliere il pubblico con un riquadro nero o un’immagine sfocata tra due scene prima della riproduzione. Paga in base all’uso, senza abbonamento.

In arrivoper richiesta + per video$0.077

Questa attività non è disponibile al momento, quindi non può essere acquistata. Non viene addebitato nulla.

Vedi l'API

Usalo da Web solo APIAPIEmailTelegramApp presto

Scegli il momento e ottieni un'immagine nitida. Accetta video fino a 500 MB.

Perché la copertina di un video conta

Un video senza copertina è un riquadro grigio che si clicca sulla fiducia. Se nessuno fornisce un’immagine, browser e lettori mostrano il vuoto, un rettangolo nero o un fotogramma scelto a caso, spesso una sfocatura a metà di una transizione. Questo costa clic, perché le persone decidono se guardare nel mezzo secondo prima di premere play, e un’immagine sbagliata sembra un caricamento rotto anche quando il video è perfetto. Questo strumento risolve un problema preciso: estrarre su richiesta un fotogramma rappresentativo dal secondo che Lei indica, da usare come copertina.

Come si ottiene il fotogramma e quando generarlo

Un video conserva immagini complete solo a intervalli, i fotogrammi chiave; quelli intermedi vengono ricostruiti dalle differenze. Per cadere esattamente sul secondo richiesto a volte bisogna decodificare in avanti dal fotogramma chiave più vicino, ed è per questo che lo strumento elabora davvero il video. Conviene generare la copertina appena il video arriva, non a ogni visualizzazione della pagina: così cataloghi e risultati di ricerca non mostrano mai un segnaposto vuoto. Altri usi tipici sono i capitoli visivi di un corso, l’anteprima di un link presa qualche secondo dopo l’inizio nero e una griglia di revisione con un fotogramma centrale di ogni video. L’immagine resta disponibile a un link per 24 ore.

La copertina fa la differenza sul clic

Prima di guardare un video, si guarda la sua miniatura. Un fotogramma sfocato o preso a caso — magari con gli occhi chiusi o l'immagine in movimento — fa scorrere oltre; un frame nitido e centrato invita al clic. Questo strumento estrae un fotogramma dal punto che scegli e lo salva come immagine, così puoi usare come copertina il momento migliore del video, non quello che il sistema pesca per caso.

Un fotogramma singolo, non una sequenza

Qui ottieni una sola immagine: il frame che ti serve, in buona risoluzione, pronto da caricare dove vuoi. È diverso dall'estrazione di tutti i fotogrammi, che serve per analizzare un video secondo per secondo. Se il tuo scopo è avere una copertina, un'anteprima o un'immagine di apertura, la miniatura singola è la scelta rapida ed economica: prendi l'istante giusto e lo scarichi come foto.

Casi d'uso

La copertina per YouTube

Un creator di Roma pubblica un tutorial e vuole una copertina che catturi l'occhio. Estrae il fotogramma in cui mostra il risultato finale e lo usa come miniatura, invece di lasciar scegliere una schermata a caso.

L'anteprima del prodotto sull'e-commerce

Un negozio online di Firenze carica i video dei prodotti. Da ognuno ricava un'immagine di apertura nitida e coerente, così la scheda prodotto ha un'anteprima curata e non un frame sfocato.

L'immagine per l'articolo

Una redazione ha il video di un evento e serve una foto per accompagnare il pezzo. La miniatura estratta dal momento clou diventa l'immagine di apertura dell'articolo.

Domande frequenti

Posso scegliere il fotogramma esatto?

Sì: indichi l'istante del video da cui prendere l'immagine, così eviti i frame sfocati o poco felici. Il risultato è la foto di quel preciso momento, non una schermata casuale.

In che qualità esce la miniatura?

Da un video a bassa risoluzione non si ottiene una foto più nitida dell'originale.

Qual è la differenza con l'estrazione dei fotogrammi?

Qui prendi una sola immagine, quella che ti serve come copertina.

Quanto costa esattamente?

Con PayPal, senza abbonamento. Per la fattura, scrivici a human@forhosting.com.

È già utilizzabile?

Non ancora: lo strumento è in fase di rilascio. Presto potrai caricare il video ed estrarre la miniatura da questa pagina. Scrivici se vuoi essere avvisato quando parte.

Strumenti correlati

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/video/thumbnail

Un POST autenticato crea l'attività; il risultato arriva via webhook o con un link firmato. Questa capacità è disponibile via API, non come strumento web interattivo.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/video/thumbnail \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video":"https://example.com/clip.mp4"}'

const res = await fetch("https://api.kit.forhosting.com/video/thumbnail", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "video": "https://example.com/clip.mp4"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video/thumbnail",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "video": "https://example.com/clip.mp4"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"video":"https://example.com/clip.mp4"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/thumbnail", 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

{
  "video": "https://example.com/clip.mp4"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.thumbnail",
  "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.077

per video$0.0045

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

Limiti

`max_mb`	500
`max_minutes`	60
`max_megapixels`	3.9

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.

Note tecniche

Uno strumento che ricava un'immagine di anteprima da un video: prende un fotogramma e te lo restituisce come foto, da usare come copertina su YouTube, anteprima in un e-commerce o immagine di apertura in una pagina.

Prezzo e stato dello strumento

Si paga con PayPal la singola immagine. Il costo è a video, non al minuto: $0.077 a richiesta più $0.0045 a file, quindi circa $0.08 per miniatura, senza abbonamento. Lo strumento è in arrivo: a breve lo userai da questa pagina web, il canale principale, mentre chi genera copertine in serie per molti video potrà appoggiarsi all'API.

Leggi la documentazione completa del KIT →