ForHosting KIT · Documents et PDF

Créez une grille de vignettes de pages PDF

Transformez le nombre de pages d’un PDF et le nombre de colonnes choisi en une spécification exacte de grille.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le calculateur renvoie le nombre de lignes nécessaire, le total des cellules et le nombre de vignettes placées sur la dernière ligne. Il convient aux visionneuses PDF, planches-contact, tableaux de révision, plans d’impression et interfaces qui doivent réserver une zone prévisible avant que les images des pages soient disponibles.

Planifiez la grille avant de produire les vignettes

Une interface de vignettes PDF doit souvent connaître sa structure avant la fin du rendu des images. Indiquez le nombre de pages du document et les colonnes souhaitées : le calculateur fournit aussitôt le nombre exact de lignes. Il précise aussi la capacité totale du rectangle et le nombre de vraies vignettes sur la dernière ligne. Ces trois valeurs vous permettent de réserver un espace stable, de créer des emplacements temporaires, de dimensionner une zone de défilement ou de répartir le rendu sans ouvrir ni modifier le PDF. Ainsi, un document de 23 pages sur cinq colonnes nécessite cinq lignes, offre 25 cellules et place trois vignettes sur la dernière ligne. Le calcul repose sur une arithmétique entière déterministe : les mêmes entrées produisent toujours le même résultat. Cette fonction ne crée aucune image, n’examine pas les octets du PDF, ne choisit pas les dimensions et n’applique aucun style. Elle traite uniquement la planification, sans réseau, transfert de fichier ni hypothèse cachée d’affichage.

Interprétez correctement lignes, cellules et dernière ligne

La valeur rows est le plus petit nombre entier de lignes pouvant accueillir toutes les pages avec le nombre de colonnes demandé. Total cells correspond aux lignes multipliées par les colonnes et décrit la capacité du rectangle complet, y compris les places inutilisées après la dernière vignette. Last-row fill compte les vignettes réelles de la dernière ligne. Lorsque le nombre de pages est exactement divisible par celui des colonnes, cette ligne est pleine et son remplissage égale le nombre de colonnes ; la valeur renvoyée n’est jamais zéro. Cette convention facilite les boucles, les libellés accessibles et la mise en forme. Les deux entrées doivent être des entiers positifs sûrs. Toute valeur fractionnaire, absente, textuelle, infinie, nulle ou négative est refusée au lieu d’être arrondie ou convertie. Moins d’une colonne est impossible, car aucune quantité finie de lignes ne peut placer des pages dans une grille sans colonne.

Exploitez le résultat dans vos flux documentaires

Dans une visionneuse, utilisez les lignes pour estimer la hauteur de la galerie à partir de la hauteur des vignettes et de leur espacement. Le total des cellules peut alimenter une liste d’emplacements de taille fixe. Comparez cette capacité au nombre de pages pour connaître les places vides, même si le remplissage final est généralement la meilleure base pour styliser la dernière ligne. Dans un tableau rendu côté serveur, les mêmes valeurs répartissent les pages en lots prévisibles ou créent des repères de pagination avant la fin des traitements d’image. Les planches-contact peuvent choisir l’orientation du papier selon les lignes, tandis que les tests vérifient une page, une grille pleine ou une ligne finale à une seule vignette. Cette fonction reçoit des métadonnées, pas le PDF : vous devez donc obtenir ailleurs un nombre de pages fiable. Chaque calcul par API coûte $0.002, et la version navigateur propose le même calcul pur de manière interactive.

Cas d’usage

Réservez la galerie d’une visionneuse PDF

Calculez les lignes avant la fin du rendu afin d’éviter les déplacements gênants de la mise en page.

Préparez une planche-contact

Déterminez la capacité rectangulaire et l’occupation finale pour le nombre de colonnes choisi.

Testez les seuils d’affichage adaptatif

Comparez les grilles exactes selon les colonnes et vérifiez les cas limites avec des tests automatisés.

Questions fréquentes

Combien coûte un calcul ?

Chaque calcul par API coûte $0.002. Le calcul interactif est également proposé sur cette page.

total_cells est-il toujours égal à page_count ?

Non. Le total décrit la capacité du rectangle entier et peut inclure des places vides sur une dernière ligne partielle.

Que se passe-t-il si la dernière ligne est pleine ?

Son remplissage égale le nombre de colonnes. Une dernière ligne complète est indiquée comme pleine, et non par zéro.

Le nombre de colonnes peut-il être nul ?

Non. Il doit s’agir d’un entier positif ; toute valeur inférieure à 1 produit une erreur d’entrée incorrecte.

Cette fonction lit-elle ou génère-t-elle le PDF ?

Non. Elle utilise seulement le nombre de pages fourni et renvoie des données de grille, sans recevoir les octets du PDF ni créer d’image.

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/pdf/page-thumbnail-grid-layout

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/pdf/page-thumbnail-grid-layout \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_count":23,"columns":5}'

const res = await fetch("https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "page_count": 23,
    "columns": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_count": 23,
    "columns": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"page_count":23,"columns":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"page_count":23,"columns":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/page-thumbnail-grid-layout", 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

{
  "page_count": 23,
  "columns": 5
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.page_thumbnail_grid_layout",
  "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`	25
`max_pages`	200

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 →