ForHosting KIT · Video

Calcoli timestamp uniformi per miniature video

Pianifichi una serie ordinata di immagini di anteprima prima ancora di decodificare un fotogramma.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Inserisca la durata del video e il numero di miniature desiderato: il calcolatore restituisce timestamp deterministici, equidistanti e espressi in secondi. Esclude intenzionalmente il primo e l’ultimo secondo, nei quali dissolvenze, fotogrammi neri, titoli e schermate finali spesso producono anteprime poco efficaci. Il risultato è pronto per un comando di estrazione, una pipeline multimediale, un generatore di storyboard o la timeline di un lettore video.

Scelga punti rappresentativi lontano dai bordi

Una buona serie di miniature dovrebbe riassumere il video, non limitarsi a dividerne la durata totale. L’istante iniziale contiene spesso un fotogramma nero, una dissolvenza in entrata, una schermata di caricamento o un fotogramma chiave incompleto. Anche l’istante finale può mostrare una dissolvenza, i titoli di coda, una schermata conclusiva oppure nessun fotogramma decodificabile esattamente al limite della durata. Il calcolatore elimina queste zone inaffidabili definendo una finestra utile che va da un secondo dopo l’inizio a un secondo prima della fine. Se Lei richiede due o più timestamp, il primo viene collocato all’inizio della finestra sicura, l’ultimo alla fine e tutti gli altri a intervalli uguali. Con un solo timestamp viene restituito il punto centrale del video. Il comportamento è esplicito e ripetibile: gli stessi valori generano sempre lo stesso piano. Può quindi passare direttamente i secondi a un processo di estrazione senza riscrivere la distribuzione né chiedere per errore il punto terminale inaccessibile del file multimediale.

Comprenda il calcolo e i suoi limiti

L’input è espresso in secondi e ammette durate frazionarie, perché i metadati dei contenuti multimediali raramente coincidono con un secondo intero. Per più miniature, l’intervallo è pari alla durata utile —la durata totale meno due secondi— divisa per il numero richiesto meno uno. Ogni timestamp è il primo secondo sicuro più tale intervallo moltiplicato per la posizione con indice iniziale zero. I risultati vengono arrotondati a non più di sei cifre decimali per mantenere stabile l’output JSON senza perdere la normale precisione inferiore al secondo. La durata deve superare due secondi: una clip più breve non contiene alcun intervallo che escluda entrambe le estremità. Il numero deve essere un intero almeno pari a uno; zero o valori negativi non definiscono un piano valido e causano un errore di input. I limiti massimi evitano array inutilmente grandi. Lo strumento calcola soltanto posizioni: non esamina i fotogrammi, non rileva scene o fotogrammi chiave e non garantisce che il decoder raggiunga esattamente la frazione richiesta.

Inserisca i timestamp nel flusso di miniature

Parta dalla durata autorevole fornita dalla sonda multimediale, dai metadati del lettore o dal servizio di caricamento. Scelga un numero adatto alla destinazione: una piccola anteprima durante lo scorrimento può richiedere pochi fotogrammi, mentre uno storyboard lungo può averne bisogno di decine. Invii i valori al calcolatore e mantenga l’ordine restituito durante l’estrazione. La maggior parte degli strumenti video accetta un tempo in secondi oppure sa convertirlo nella propria notazione. Poiché il piano è uniforme, è adatto anche a chiavi di cache deterministiche e processi ripetibili: un nuovo tentativo chiederà le stesse posizioni. La precisione effettiva dipende dall’estrattore. Alcune modalità rapide saltano al fotogramma chiave più vicino; quelle accurate decodificano fino al tempo richiesto. Per una copertura basata sul contenuto usi il rilevamento delle scene. Per una copertura temporale prevedibile, lavori in batch, fixture di test e strisce di anteprima, questi timestamp offrono un contratto semplice, trasparente e riproducibile.

Crei una striscia di anteprime

Generi posizioni prevedibili per le immagini mostrate mentre una persona scorre la timeline del video.

Pianifichi uno storyboard

Produca un provino a contatto uniforme senza selezionare fotogrammi neri iniziali o schermate finali.

Programmi estrazioni in batch

Passi un array stabile di timestamp a un processo FFmpeg, a un worker multimediale o a una pipeline di caricamento.

Quanto costa?

Ogni richiesta API costa $0.002. Può anche eseguire il calcolatore nel browser.

Perché vengono esclusi il primo e l’ultimo secondo?

Queste zone contengono spesso dissolvenze, fotogrammi neri, titoli, crediti o un limite non decodificabile, quindi generano anteprime scadenti.

Che cosa accade con una sola miniatura?

Il calcolatore restituisce il punto centrale del video, che rientra nella finestra sicura per ogni durata accettata.

Lo strumento estrae le immagini?

No. Restituisce soltanto i timestamp; usi il risultato con un decoder video o uno strumento di estrazione.

Sono ammessi i secondi frazionari?

Sì. Durata e timestamp possono includere frazioni; l’output viene arrotondato a un massimo di sei cifre decimali.

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.

POSThttps://api.kit.forhosting.com/video/thumbnail-timestamps

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

curl -X POST https://api.kit.forhosting.com/video/thumbnail-timestamps \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration_seconds":120,"count":5}'
{
  "duration_seconds": 120,
  "count": 5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.thumbnail_timestamps",
  "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.

per richiesta$0.002

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

max_items10000
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →