Metadati di un video
Invii il link di un video e riceva durata, contenitore, codec di immagine e suono, risoluzione, frequenza dei fotogrammi e bitrate di ogni flusso, letti dai flussi stessi e non dal nome del file. Si paga a consumo, senza abbonamento.
Questa attività non è disponibile al momento, quindi non può essere acquistata. Non viene addebitato nulla.
Vedi l'APIServe a capire com'è fatto un video prima di caricarlo, convertirlo o inviarlo. Non modifica il file. Accetta video fino a 500 MB.
Perché contano i dati reali di un file
Prima di ricodificare, smistare, fatturare o rifiutare un video, bisogna sapere che cosa è davvero. Un caricamento può presentarsi come qualsiasi cosa, per esempio con il contenitore sbagliato, una risoluzione che non corrisponde al nome, un bitrate variabile che compare solo a metà file o una traccia audio in un codec che il lettore non supporta. Contenitori come MP4 o MKV possono racchiudere flussi in decine di codec, ognuno con il suo modo di registrare durata e bitrate.
Come funziona la lettura e dove si inserisce
Il servizio esamina il contenitore e ogni flusso invece di fidarsi alla cieca dell'intestazione, poi restituisce durata, formati, codec, risoluzione, frequenza, bitrate di ogni flusso e numero di flussi in una forma prevedibile. Proprio perché il risultato è costante, si colloca bene prima di altri passaggi, come un filtro che scarta i file sotto una qualità minima, la scelta se ricodificare o no, una verifica dello spazio basata su bitrate e durata reali o un controllo dei formati supportati da un dispositivo.
Che cosa ti dicono i metadati
Sono le informazioni che spiegano perché un video pesa tanto, perché non si carica su una piattaforma o perché scatta durante la riproduzione. Lo strumento le legge e te le presenta in modo comprensibile, senza aprire programmi tecnici né interpretare sigle da solo.
A cosa serve leggerli prima di agire
Conoscere i dati di un video evita passi falsi. Prima di caricarlo su un portale con requisiti precisi, controlli che risoluzione e codec siano quelli richiesti. Prima di convertirlo, capisci da dove parti.
Se un file non si apre da nessuna parte, i metadati spesso rivelano un codec insolito. È una diagnosi rapida: guardi la scheda e sai subito se il video va bene così o va prima adattato con un altro strumento.
Casi d'uso
Capire perché un video non si carica
Marco prova a caricare un video su una piattaforma che lo rifiuta senza spiegazioni. Leggendo i metadati scopre un codec non supportato: ora sa che deve convertirlo prima, invece di ritentare a vuoto.
Controllare la risoluzione prima di pubblicare
Un negozio online vuole essere sicuro che i video prodotto rispettino la risoluzione richiesta dal marketplace. La scheda tecnica lo conferma in un secondo, prima del caricamento.
Verificare la durata esatta
Una redazione deve rispettare un limite di durata preciso per un video. I metadati mostrano i secondi esatti, così sa se tagliare o se il file è già nei tempi.
Domande frequenti
Lo strumento modifica il video?
No: si limita a leggere e mostrare le informazioni del file. Il video resta esattamente com'è. Per cambiare formato, risoluzione o peso servono gli strumenti dedicati.
Quali informazioni ottengo esattamente?
Durata, risoluzione in pixel, codec video e audio, bitrate, frame rate e i dati della traccia sonora. In pratica tutto ciò che serve per sapere com'è fatto il file e se è adatto alla tua destinazione.
Perché mi serve conoscere il codec?
Perché è la causa più frequente di un video che non si apre o non si carica: un codec insolito non è supportato ovunque. Sapendolo, capisci se convertire il file prima di usarlo.
È già utilizzabile?
Non ancora: lo strumento è in fase di rilascio. Presto potrai caricare il video e leggerne la scheda tecnica da questa pagina. Scrivici per essere avvisato quando parte.
Perché non fidarsi del nome del file?
Un file caricato può fingere di essere qualsiasi cosa: contenitore sbagliato, risoluzione diversa da quella del nome, bitrate che cambia a metà. Esaminare i flussi stessi rivela ciò che un'intestazione incoerente o mancante nasconderebbe.
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
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/metadata \
-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/metadata", {
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/metadata",
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/metadata", 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/metadata", 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.metadata",
"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
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 legge le informazioni tecniche di un file video e te le mostra in chiaro: durata esatta, risoluzione in pixel, codec usato, bitrate, frame rate e traccia audio.
Che cosa ti dicono i metadati
Ogni file video porta con sé una scheda tecnica: quanto dura al secondo, quanti pixel misura, con quale codec è compresso, quanti fotogrammi al secondo mostra e a che bitrate.
Prezzo e stato dello strumento
Si paga con PayPal la singola operazione. Il costo è a video, non al minuto: $0.077 a richiesta più $0.0045 a file, quindi circa $0.08 a lettura, senza abbonamento. Lo strumento è in arrivo: presto lo userai da questa pagina web, il canale principale, con l'API per chi verifica in automatico le caratteristiche di molti file prima di elaborarli.
Domande tecniche
Quanto costa leggere i metadati?
Si paga a file, non al minuto: $0.077 a richiesta più $0.0045 a video, circa $0.08 a lettura, con PayPal e senza abbonamento.