ForHosting KIT · Vidéo

Calculer le recadrage vidéo selon le ratio d'image

Adapter une vidéo à un nouveau format d’affichage commence par une question précise : quel rectangle centré conserve la plus grande surface possible tout en respectant le ratio de destination ?

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Ce calculateur reçoit la largeur et la hauteur en pixels de la vidéo source, ainsi qu’un ratio tel que 9:16, 1:1 ou 16:9. Il renvoie l’origine et les dimensions du recadrage sans téléverser, décoder, redimensionner ni modifier la vidéo. Vous pouvez transmettre directement cette géométrie à un flux de montage, une commande de transcodage, une chaîne multimédia ou une interface d’aperçu.

Transformez l’image source en un recadrage maximal adapté

Saisissez la largeur et la hauteur en pixels de la vidéo décodée, puis indiquez le ratio de destination sous la forme largeur sur hauteur, avec deux-points entre les valeurs. Par exemple, 1920 par 1080 décrit une image horizontale courante, tandis que 9:16 demande un résultat vertical adapté aux vidéos mobiles courtes. Le calculateur compare le ratio source au ratio demandé et conserve la dimension qui limite déjà l’ajustement. Si la source est trop large, il garde toute la hauteur et réduit la largeur. Si elle est trop haute, il garde toute la largeur et réduit la hauteur. Il obtient ainsi le plus grand rectangle pouvant tenir dans l’image d’origine sans étirement, marge ni dépassement. Les valeurs x et y situent le coin supérieur gauche, tandis que width et height décrivent la taille. Ensemble, elles forment une zone de recadrage complète pour chaque image d’une vidéo à résolution constante. Aucun octet multimédia n’est requis, car seule la géométrie intervient dans le calcul.

Interprétez le centrage et les pixels fractionnaires

Un recadrage centré retire la même quantité sur deux bords opposés. Lorsqu’une source horizontale doit être rétrécie, x correspond à la moitié de la zone horizontale supprimée et y reste nul. Lorsque l’image doit être moins haute, y correspond à la moitié de la zone verticale supprimée et x reste nul. Certaines combinaisons de dimensions et de ratios produisent des coordonnées ou des tailles fractionnaires. Ce comportement est voulu : le centre mathématique exact ou le ratio demandé peut se trouver entre les limites physiques des pixels. La géométrie décimale évite d’imposer discrètement une règle d’arrondi qui ne conviendrait pas à votre encodeur, bibliothèque graphique ou logiciel de montage. Les valeurs sont normalisées à neuf décimales afin que les requêtes répétées restent stables et que le bruit des nombres flottants ne se propage pas aux manifestes ou aux tests. Si l’outil destinataire exige des entiers, appliquez sa règle d’arrondi documentée lors de l’intégration et vérifiez les dimensions finales encodées.

Employez le recadrage sans risque en production vidéo

Considérez la réponse comme une géométrie réutilisable, et non comme une vidéo transformée. Transmettez x, y, width et height à l’étape de recadrage de votre transcodeur, logiciel de montage non linéaire, moteur canvas, générateur de vignettes ou service multimédia. Vérifiez que l’outil cible place l’origine en haut à gauche, avec x croissant vers la droite et y vers le bas, conformément à la convention adoptée ici. Lisez la largeur et la hauteur du flux vidéo réellement décodé, plutôt que de vous fier au nom du fichier, à la fenêtre du lecteur ou à une fiche obsolète. Les vidéos de téléphone peuvent contenir des métadonnées d’orientation : décidez si votre chaîne applique cette rotation avant ou après le recadrage et fournissez les dimensions de la même étape. L’analyseur n’accepte que deux nombres positifs et finis séparés par deux-points. Fautes, autres séparateurs, zéros, valeurs négatives et texte supplémentaire sont rejetés plutôt que devinés. Cette rigueur évite des séries entières de cadrages incorrects.

Adaptez une vidéo horizontale aux canaux verticaux

Calculez la plus grande zone centrée en 9:16 avant d’encoder des versions propres à chaque plateforme depuis un master horizontal.

Uniformisez le cadrage des vignettes vidéo

Utilisez un calcul déterministe pour les aperçus et vignettes qui doivent remplir un lecteur fixe sans marges.

Validez un préréglage de transcodage automatique

Prévisualisez les coordonnées issues des métadonnées et rejetez les ratios incorrects avant tout traitement multimédia coûteux.

Cet outil téléverse-t-il ou modifie-t-il la vidéo ?

Non. Il utilise seulement la largeur, la hauteur et le ratio pour renvoyer une géométrie, sans recevoir, décoder, stocker ni transformer de média.

Quel est le coût du calcul ?

Le tarif de l’API est de $0.002 par requête. Le même calcul déterministe peut aussi être exécuté dans le navigateur.

Quelle syntaxe de ratio est acceptée ?

Utilisez deux nombres positifs séparés par deux-points, comme 9:16, 16:9, 1:1 ou 1.85:1. Les autres séparateurs et le texte ajouté sont refusés.

Pourquoi le recadrage peut-il contenir des décimales ?

Le centre ou le ratio exact peut tomber entre deux pixels. La géométrie décimale conserve le plus grand recadrage centré sans imposer d’arrondi.

Le recadrage peut-il dépasser l’image source ?

Non. Une dimension correspond toujours à celle de la source, et l’autre est réduite pour respecter le ratio demandé.

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.

POSThttps://api.kit.forhosting.com/video/aspect-ratio-crop

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é.

curl -X POST https://api.kit.forhosting.com/video/aspect-ratio-crop \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1920,"height":1080,"ratio":"9:16"}'
{
  "width": 1920,
  "height": 1080,
  "ratio": "9:16"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.aspect_ratio_crop",
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

max_mb500
max_minutes60
max_megapixels3.9
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →