Informations d’une vidéo
Envoyez le lien d'une vidéo et recevez sa durée, son conteneur, ses codecs image et son, sa définition, sa cadence et le débit de chaque flux, lus dans les flux eux-mêmes et non dans le nom du fichier. Paiement à l'usage, sans abonnement.
Cette tâche n'est pas disponible pour le moment et ne peut donc pas être achetée. Rien n'est facturé.
Voir l’APILire les métadonnées d’une vidéo, c’est afficher ses caractéristiques techniques sans la regarder : durée exacte, définition, codec, débit, fréquence d’images et présence d’une piste audio. Vous déposez le fichier, l’outil renvoie sa fiche technique, utile pour vérifier qu’une vidéo respecte les exigences d’une plateforme.
Pourquoi les vraies caractéristiques d'un fichier comptent
Avant de transcoder, d'aiguiller, de facturer ou de refuser une vidéo, il faut savoir ce qu'elle est vraiment. Un envoi peut prétendre être n'importe quoi : un mauvais conteneur, une définition qui ne correspond pas à son nom, un débit variable qui n'apparaît qu'au milieu du fichier ou une piste audio dans un codec que votre lecteur ne gère pas. Les conteneurs comme MP4 ou MKV peuvent envelopper des flux dans des dizaines de codecs, chacun stockant durée et débit à sa manière.
Comment se fait la lecture et où elle s'insère
Le service examine le conteneur et chaque flux au lieu de se fier aveuglément à l'en-tête, puis renvoie durée, formats, codecs, définition, cadence, débit de chaque flux et nombre de flux sous une forme prévisible. Ce résultat constant se place bien avant d'autres étapes : un contrôle qui refuse les fichiers sous une qualité minimale, la décision de réencoder ou non, un audit de stockage fondé sur le débit et la durée réels, ou une vérification des formats pris en charge par un appareil.
La fiche technique d’un fichier
Chaque vidéo contient des informations sur elle-même : sa durée, sa définition en pixels, le codec qui l’encode, son débit, sa fréquence d’images par seconde et ses pistes son. Les lire évite d’ouvrir la vidéo pour deviner ces réglages. L’outil parcourt le fichier et rend ces données lisibles, d’un coup d’œil, sans lancer la lecture ni modifier quoi que ce soit à la vidéo elle-même.
Vérifier avant de publier
Avant un dépôt, une plateforme impose souvent une définition maximale, un codec précis ou une durée limite. Lire les métadonnées permet de contrôler ces points d’avance et d’éviter un refus au moment de l’envoi. C’est aussi le moyen de comprendre pourquoi une vidéo pèse lourd — un débit élevé, une haute définition — avant de décider s’il faut la compresser ou la redimensionner.
Cas d’usage
Contrôle avant dépôt
Sophie Nguyen vérifie la définition et le codec d’une vidéo avant de la téléverser sur une plateforme exigeante, pour s’épargner un rejet au dernier moment.
Comprendre un fichier lourd
Atelier Garnier SARL lit le débit d’une vidéo trop volumineuse pour décider s’il faut la compresser ou seulement la redimensionner avant l’envoi.
Inventaire d’archives
Un vidéaste relève la durée et la fréquence d’images de plusieurs rushes pour les classer sans avoir à ouvrir chaque fichier dans un lecteur.
Questions fréquentes
Quelles informations l’outil renvoie-t-il ?
La durée, la définition en pixels, le codec vidéo, le débit, la fréquence d’images par seconde et les pistes audio présentes. De quoi connaître un fichier sans le lire.
La vidéo est-elle modifiée par cette lecture ?
Non. L’outil se contente de lire les informations du fichier ; il ne réencode rien et ne touche ni à l’image ni au son de la vidéo.
Ma vidéo est-elle conservée après la lecture ?
Non. Le fichier passe par nos serveurs le temps d’en lire les informations, via un transfert chiffré, puis il est effacé. Seule la fiche technique vous est renvoyée.
Pourquoi ne pas se fier au nom du fichier ?
Un fichier envoyé peut prétendre être n'importe quoi : mauvais conteneur, définition qui ne correspond pas au nom, débit qui change en cours de route. Examiner les flux eux-mêmes révèle ce qu'un en-tête incohérent ou absent cacherait.
À quoi servent ces informations avant un transcodage ?
Le codec et le débit indiquent si un fichier doit être réencodé ou peut être diffusé tel quel, ce qui évite des conversions inutiles. La durée et la définition permettent aussi de refuser un envoi trop faible.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Un POST authentifié crée la tâche ; le résultat arrive par webhook ou par un lien signé. Cette capacité est disponible par API, pas comme outil web interactif.
Appeler depuis votre 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)Exemple de requête
{
"video": "https://example.com/clip.mp4"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.metadata",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_mb | 500 |
max_minutes | 60 |
max_megapixels | 3.9 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Un tarif par vidéo
Pas d’abonnement ni de solde : vous réglez la lecture demandée, une fois. La lecture des métadonnées se paie à la vidéo, en dollars US, et non à la minute : $0.077 par requête, plus $0.0045 par vidéo, soit environ $0.08 par fichier analysé, quelle que soit sa durée. La capacité est en cours de déploiement ; le prix est affiché, l’exécution ouvrira sur cette page, puis via l’API.
Questions techniques
Le tarif dépend-il de la durée du fichier ?
Non. La lecture se facture à la vidéo : $0.077 par requête plus $0.0045 par fichier, soit environ $0.08, que la vidéo dure une minute ou une heure.
L’outil est-il déjà disponible ?
Il est en cours de déploiement. Le tarif est affiché et l’exécution ouvrira sous peu, sur cette page puis via l’API.