ForHosting KIT · Documents et PDF

Pages PDF N-up

Le calculateur de mise en page PDF N-up transforme le format d’une page d’origine et un nombre de pages par feuille pris en charge en un plan de placement complet.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il fournit les dimensions de la grille, la largeur et la hauteur requises pour la feuille de sortie ainsi que la position exacte de chaque cellule. Utilisez la même unité pour la largeur et la hauteur : le résultat conservera cette unité. Le calcul est déterministe et ne modifie, ne téléverse ni ne restitue le document.

Commencez par les dimensions de la page PDF d’origine

Une mise en page N-up part du format de support d’une page PDF d’origine. Indiquez ce format avec page_width et page_height, dans la même unité. Les logiciels PDF expriment souvent les dimensions en points, à raison de soixante-douze points par pouce, mais le calculateur n’impose aucune unité. Les millimètres, les pouces ou toute autre mesure cohérente conviennent, car les résultats sont obtenus par multiplication et non par conversion. L’outil suppose que toutes les pages sources ont les dimensions fournies. Si un document mêle orientation portrait, paysage et formats personnalisés, calculez un plan pour chaque groupe ou normalisez d’abord les pages. Les deux dimensions doivent être des nombres finis strictement positifs ; les valeurs nulles, négatives, absentes, infinies ou non numériques sont refusées. Cette validation empêche de produire une feuille apparemment correcte à partir d’une géométrie inutilisable. La capacité reçoit la géométrie, pas les octets du PDF : extrayez auparavant la largeur et la hauteur de la zone de média.

Choisissez une grille de pages par feuille prise en charge

Définissez n sur 2, 4, 6 ou 9. Chaque valeur correspond à une grille prévisible : deux pages occupent deux colonnes et une ligne ; quatre pages, deux colonnes et deux lignes ; six pages, trois colonnes et deux lignes ; neuf pages, trois colonnes et trois lignes. Cette correspondance explicite évite les dispositions ambiguës et stabilise les traitements répétés. La largeur de la feuille de sortie est la largeur d’origine multipliée par le nombre de colonnes ; sa hauteur est la hauteur d’origine multipliée par le nombre de lignes. Chaque page reste à sa taille réelle, sans mise à l’échelle, rotation, marge, gouttière, fond perdu ni repère de coupe. Ces choix de production peuvent être appliqués ensuite par un outil d’imposition ou de rendu. Toute valeur non prise en charge est refusée au lieu d’être arrondie ou forcée dans une grille incomplète. Les erreurs de configuration apparaissent ainsi immédiatement, notamment lorsque n provient d’une préférence, d’un modèle enregistré ou d’une option de commande.

Exploitez le plan de placement pour créer chaque feuille

Le tableau placements décrit les cellules ligne par ligne avec page_index, row et column indexés à partir de zéro. La première page source occupe la cellule supérieure gauche ; les suivantes avancent sur la ligne, puis une nouvelle ligne commence après la dernière colonne. Chaque placement comprend les coordonnées x et y, ainsi que la largeur et la hauteur inchangées de la cellule. L’origine se situe en haut à gauche : x augmente vers la droite et y vers le bas. Si votre bibliothèque PDF utilise une origine en bas à gauche, convertissez y lors du rendu en soustrayant y et la hauteur de cellule de sheet_height. Pour chaque feuille, prenez les n pages sources suivantes et appliquez les mêmes placements dans l’ordre. La dernière feuille peut en contenir moins : ignorez les placements inutilisés, sauf si votre flux impose un remplissage. Le résultat peut piloter la création du PDF, les aperçus, les contrôles d’imposition ou les fiches de production sans répéter les calculs.

Cas d’usage

Préparer un travail d’imposition

Créez la feuille cible et placez chaque page à des coordonnées déterministes avant de produire le PDF de sortie.

Estimer les dimensions de la feuille

Calculez le canevas à taille réelle d’une disposition N-up prise en charge sans ouvrir ni modifier le document source.

Valider les réglages d’impression

Refusez rapidement les nombres de pages non pris en charge et comparez la grille aux contraintes d’impression ou de finition.

Questions fréquentes

Quel est le tarif ?

Chaque requête API coûte $0.002. Le calcul peut également être exécuté dans le navigateur.

Quelles valeurs N-up sont prises en charge ?

Les valeurs acceptées sont 2, 4, 6 et 9. Toute autre valeur renvoie une erreur d’entrée non valide.

Quelle unité de mesure dois-je utiliser ?

Choisissez toute unité, à condition que page_width et page_height utilisent la même. Les résultats la conservent.

Le calculateur redimensionne-t-il ou fait-il pivoter les pages ?

Non. Il conserve la largeur et la hauteur fournies et calcule une grille à taille réelle, sans rotation, échelle, marge ni gouttière.

Mon PDF est-il téléversé ou réécrit ?

Non. Seule la géométrie est calculée à partir des dimensions et de n ; les octets du PDF ne sont ni lus, ni stockés, ni rendus, ni modifié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

POSThttps://api.kit.forhosting.com/pdf/n-up-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/n-up-layout \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_width":612,"page_height":792,"n":4}'

const res = await fetch("https://api.kit.forhosting.com/pdf/n-up-layout", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "page_width": 612,
    "page_height": 792,
    "n": 4
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/n-up-layout",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_width": 612,
    "page_height": 792,
    "n": 4
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/n-up-layout", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"page_width":612,"page_height":792,"n":4}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"page_width":612,"page_height":792,"n":4}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/n-up-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_width": 612,
  "page_height": 792,
  "n": 4
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.n_up_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 →