Vérifiez le format d’une vidéo pour chaque plateforme
Une vidéo peut être techniquement valide tout en étant mal adaptée à sa destination.
Lancer gratuitement
Cet outil compare le rapport largeur-hauteur fourni au cadre fixe d’un emplacement précis sur une plateforme sociale. Il vous indique si la géométrie correspond, si une source plus étroite nécessiterait des bandes latérales ou si les côtés d’une source plus large seraient recadrés. Aucun fichier n’est téléversé ni décodé : saisissez le ratio, la plateforme et l’emplacement pour obtenir une réponse déterministe utile à la planification, à la validation ou à un processus automatisé de publication.
Choisissez la destination avant d’évaluer la source
La conformité d’un ratio dépend d’un emplacement, et pas seulement du nom de la plateforme. Une vidéo YouTube classique emploie un cadre horizontal, tandis que YouTube Shorts utilise un cadre vertical. Instagram distingue également le fil portrait, le fil carré, Reels et Stories. Sélectionnez précisément la paire correspondant à la destination de la ressource, puis indiquez son ratio affiché sous la forme largeur:hauteur, par exemple 16:9, 9:16, 4:5 ou 1:1. Les composantes décimales sont acceptées pour les formats moins courants. L’outil normalise les libellés en minuscules, consulte le cadre déclaré et compare les deux valeurs numériques. Il n’examine ni nom de fichier, ni résolution, ni balise de rotation, ni flux encodé. Si une vidéo de téléphone possède une orientation dans ses métadonnées, déterminez les dimensions après rotation et transmettez le ratio réellement visible. Les combinaisons inconnues sont refusées explicitement afin qu’une automatisation n’applique pas par erreur une règle de fil à une story ou la convention d’une autre plateforme.
Interprétez la conformité, les bandes et le recadrage
Un résultat conforme signifie que la source et la destination ont la même forme mathématique, avec une très faible tolérance liée aux nombres flottants. Aucun ajustement géométrique n’est nécessaire. Un résultat avec bandes signifie que la source est plus étroite que le cadre de destination. Conserver toute l’image laisse alors un espace inutilisé sur les côtés, généralement appelé pillarboxing, même si l’API retient la catégorie générale letterboxed. Un résultat recadré signifie que la source est plus large que la destination. Remplir le cadre sur toute sa hauteur supprimerait du contenu à gauche et à droite. Ces libellés décrivent un ajustement géométrique centré, et non le comportement garanti de chaque interface de téléversement. Une plateforme peut proposer un cadrage manuel, un fond flouté, plusieurs ratios ou modifier son produit. Servez-vous du résultat pour décider si une vérification éditoriale est nécessaire. En cas de recadrage, contrôlez les sujets, sous-titres et logos proches des bords. Avec des bandes, choisissez si un fond conçu est préférable.
Contrôlez avant la publication et le transcodage
Lancez ce contrôle dès que vous attribuez une destination, avant de consacrer du temps au rendu final, au téléversement ou à la révision du média. Un système éditorial peut conserver la plateforme et l’emplacement prévus avec chaque ressource, calculer le ratio affiché depuis des métadonnées fiables, puis appeler cette capacité comme étape de validation. Les correspondances exactes peuvent continuer automatiquement. Les autres résultats peuvent créer une tâche de révision, sélectionner une version alternative déjà préparée ou envoyer la ressource vers un calcul de recadrage distinct. Conservez required_ratio dans le journal d’audit afin que l’équipe comprenne la cible ayant motivé la décision. La réponse répète aussi la plateforme, l’emplacement et le ratio normalisés, ce qui clarifie les journaux lorsqu’une source alimente plusieurs canaux. Cette capacité ne redimensionne pas les pixels, ne calcule pas les zones sûres, ne prédit pas la compression et ne prétend pas qu’un envoi sera refusé. Via l’API, chaque contrôle déterministe coûte $0.002, sans transfert du média.
Cas d’usage
Validez les ressources avant programmation
Signalez un format incompatible avant que la file de publication n’envoie la vidéo à l’emplacement choisi.
Sélectionnez la bonne version source
Comparez la source à la destination et dirigez la tâche vers une version horizontale, carrée, portrait ou verticale.
Créez une règle de contrôle éditorial
Faites vérifier les bords des recadrages et prévoyez un fond ou une composition pour les bandes.
Questions fréquentes
Que signifie un résultat conforme ?
Le ratio fourni possède la même forme numérique que l’exigence enregistrée pour cette plateforme et cet emplacement.
Pourquoi l’outil annonce-t-il des bandes ?
La source est plus étroite que le cadre ; la conserver entière laisserait des bandes ou un autre fond sur les côtés.
Que signifie le recadrage ici ?
La source est plus large que la destination ; un remplissage centré supprimerait donc une partie de ses côtés gauche et droit.
Cet outil téléverse-t-il ou modifie-t-il la vidéo ?
Non. Il compare uniquement les ratios, sans recevoir, décoder, stocker, redimensionner, recadrer ni transcoder le média.
Combien coûte un contrôle par API ?
Chaque requête API coûte $0.002. Aucun coût variable de traitement ne s’ajoute puisque la vidéo n’est pas transférée.
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
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/video/video-aspect-platform-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"ratio":"16:9","platform":"youtube","placement":"video"}'const res = await fetch("https://api.kit.forhosting.com/video/video-aspect-platform-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/video-aspect-platform-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/video-aspect-platform-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ratio":"16:9","platform":"youtube","placement":"video"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ratio":"16:9","platform":"youtube","placement":"video"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/video-aspect-platform-check", 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
{
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.video_aspect_platform_check",
"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. |