ForHosting KIT · Images

Recadrer une image au bon ratio

Recadrer une image selon un ratio précis paraît simple, mais le calcul est facile à fausser.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Cet outil reçoit la largeur et la hauteur de la source ainsi qu’un ratio comme 16:9, puis renvoie le plus grand rectangle de cette forme qui tient dans l’image. Le cadrage est centré : des quantités égales sont retirées sur les côtés opposés. Aucun fichier n’est envoyé ni transformé ; le résultat fournit des coordonnées réutilisables dans un éditeur, un script, une chaîne d’images ou une mise en page adaptative.

Transformez les dimensions et le ratio en zone de recadrage

Saisissez la largeur et la hauteur de l’image en pixels, puis indiquez le ratio cible sous la forme largeur sur hauteur, avec deux-points entre les valeurs. Les choix courants sont 1:1 pour les vignettes carrées, 4:3 pour la photographie classique, 16:9 pour les médias panoramiques et 9:16 pour les stories verticales. Le calculateur compare le ratio source au ratio demandé afin de repérer la dimension qui convient déjà. Si la source est trop large, toute la hauteur est conservée et la largeur diminue. Si elle est trop haute, toute la largeur est conservée et la hauteur diminue. Les valeurs x et y situent l’angle supérieur gauche, tandis que width et height donnent la taille. Ces quatre valeurs composent une zone complète. La recherche du plus grand rectangle évite de réduire inutilement les deux dimensions. Aucun rééchantillonnage, étirement ou remplissage n’est appliqué : le résultat décrit uniquement la région centrale à conserver.

Comprenez le centrage et les coordonnées fractionnaires

Un recadrage centré retire la même quantité sur chacune des deux bordures opposées. Lorsqu’une image horizontale doit devenir plus étroite, x vaut la moitié de la largeur supprimée et y vaut zéro. Lorsqu’une image verticale ou carrée doit perdre de la hauteur, y vaut la moitié de la hauteur supprimée et x vaut zéro. Certaines combinaisons produisent des coordonnées ou dimensions décimales. C’est mathématiquement exact : le centre ou le ratio précis peut se trouver entre deux pixels physiques. De nombreuses bibliothèques acceptent une géométrie flottante ou réalisent leur propre échantillonnage au rendu. Si votre bibliothèque exige des entiers, appliquez sa règle d’arrondi documentée au dernier moment, car le rectangle en pixels peut différer légèrement du ratio exact. Conserver la précision évite d’imposer une règle cachée et garantit un résultat déterministe dans le navigateur, l’API et les automatisations.

Intégrez le résultat sans risque dans votre flux d’images

Considérez la réponse comme une géométrie, et non comme une image modifiée. Transmettez x, y, width et height à la fonction de découpe de votre bibliothèque graphique, outil en ligne de commande, routine canvas ou service multimédia. Vérifiez que la destination place l’origine en haut à gauche : ce calculateur suit la convention courante où x augmente vers la droite et y vers le bas. Utilisez les dimensions du fichier réellement décodé plutôt qu’un nom ou des métadonnées provenant d’une autre version. Le ratio doit contenir exactement deux nombres positifs séparés par deux-points ; les textes incorrects, zéros, valeurs négatives et autres séparateurs sont refusés. Cette rigueur protège les traitements par lots contre des centaines de ressources erronées. Le calcul n’emploie ni réseau, ni hasard, ni horodatage, ni analyse visuelle cachée : des entrées identiques donnent toujours la même géométrie, qui peut être mise en cache ou consignée.

Cas d’usage

Préparer des visuels cohérents pour les réseaux sociaux

Calculez des zones centrées 1:1, 4:5 ou 9:16 avant de produire les variantes propres à chaque canal.

Construire une chaîne de vignettes

Transmettez une géométrie déterministe au processeur afin de remplir chaque cadre sans déformation ni marge.

Prévisualiser un cadrage éditorial

Affichez la plus grande région centrée avant que la rédaction décide d’un ajustement adapté au sujet.

Questions fréquentes

Cet outil recadre-t-il ou téléverse-t-il mon image ?

Non. Il calcule des coordonnées à partir des dimensions et d’un ratio, sans recevoir, stocker, décoder ni modifier l’image.

Combien coûte le calcul ?

Le tarif de l’API est de $0.002 par requête. La version navigateur exécute localement le même calcul déterministe.

Pourquoi le résultat contient-il parfois des pixels décimaux ?

Le centre ou le ratio exact peut tomber entre deux pixels. La géométrie décimale préserve le plus grand recadrage mathématique.

Quelle syntaxe de ratio est acceptée ?

Utilisez deux nombres positifs séparés par deux-points, par exemple 16:9, 4:3, 1:1 ou 1.85:1. Tout autre séparateur ou texte est refusé.

La zone peut-elle dépasser l’image source ?

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

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

POSThttps://api.kit.forhosting.com/image/crop-to-aspect

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/image/crop-to-aspect \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1920,"height":1080,"ratio":"4:3"}'

const res = await fetch("https://api.kit.forhosting.com/image/crop-to-aspect", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 1920,
    "height": 1080,
    "ratio": "4:3"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/crop-to-aspect",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 1920,
    "height": 1080,
    "ratio": "4:3"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/crop-to-aspect", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":1920,"height":1080,"ratio":"4:3"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":1920,"height":1080,"ratio":"4:3"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/crop-to-aspect", 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

{
  "width": 1920,
  "height": 1080,
  "ratio": "4:3"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.crop_to_aspect",
  "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

par requête$0.002

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

Limites

`max_mb`	15
`max_megapixels`	12

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.

Consulter la documentation complète du KIT →