Convertir un PDF en niveaux de gris page par page
Quatre pages notées couleur, gris, CMJN et gris reviennent comme quatre pages en niveaux de gris, avec un décompte qui montre que 2 seulement devaient changer. Servez-vous-en pour préparer une conversion ou repérer les fichiers mixtes. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Pages
- color, grayscale, CMYK, grayscale
- Pages
- grayscale, grayscale, grayscale, grayscale
- Nombre de pages
- 4
- Pages modifiées
- 2
Convertissez un PDF en niveaux de gris au stade des métadonnées de page grâce à une opération simple et déterministe. Indiquez le mode couleur actuel de chaque page dans l’ordre du document : vous obtenez une liste correspondante où chaque page porte la valeur grayscale. Le résultat précise également le nombre total de pages et le nombre exact de modes modifiés, afin de distinguer une conversion complète d’un document déjà préparé. Les documents vides sont refusés avec une erreur de saisie explicite.
Représentez le PDF par une suite ordonnée de modes
Cette capacité exploite les informations de mode couleur par page produites lors d’une étape préalable d’inspection ou de traitement du PDF. Fournissez une chaîne non vide pour chaque page, en respectant l’ordre du document. Un PDF de trois pages peut, par exemple, être décrit par color, grayscale et cmyk.
La sortie contient trois positions dans le même ordre, toutes fixées à grayscale. Puisque l’opération porte sur des descripteurs de pages plutôt que sur des données binaires téléversées, elle reste prévisible, rapide et facile à placer entre l’analyse du PDF et une étape ultérieure de rendu ou d’exportation. L’entrée doit contenir au moins une page.
Si le champ pages manque, si la liste est vide, si la valeur n’est pas une liste ou si un mode est vide, la requête est rejetée au lieu d’être interprétée comme un document valide sans page. Cette validation stricte révèle les erreurs du flux et évite de confondre l’absence de résultat de l’analyseur avec une conversion réussie. L’ordre n’est jamais trié, dédupliqué ni modifié.
Intégrez le résultat à votre traitement PDF
Le résultat convient aux flux qui séparent l’inspection du PDF, la préparation des transformations et le rendu du fichier. Un analyseur ou un système documentaire détermine d’abord le mode actuel de chaque page. Cette capacité normalise ensuite le plan et indique combien de descripteurs doivent changer.
Cette capacité n’ouvre pas le PDF, ne le pixellise pas, ne le recolore pas et ne renvoie aucun fichier binaire ; elle transforme la description par page fournie par vous. Cette limite autorise une utilisation dans le navigateur et une automatisation déterministe, mais toute modification réelle des pixels exige encore un moteur de rendu PDF adapté.
Le compteur peut alimenter un aperçu tel que « 12 pages sur 30 seront modifiées », vérifier qu’un document annoncé comme converti ne contient plus de mode couleur, ou repérer un fichier source mixte inattendu.
Cas d’usage
Préparer un plan de conversion
Normalisez les modes détectés avant d’envoyer au moteur PDF une liste ordonnée de cibles en niveaux de gris.
Auditer des documents mixtes
Comptez les pages d’un PDF reçu qui ne portent pas encore la valeur grayscale.
Contrôler une conversion en amont
Vérifiez qu’un document traité ne nécessite plus de modification sans accepter un résultat vide.
Questions fréquentes
Cette capacité renvoie-t-elle un PDF converti ?
Non. Elle normalise les descripteurs de mode couleur fournis. Un moteur PDF ultérieur doit appliquer le mode demandé aux pixels et aux ressources.
L’ordre des pages change-t-il ?
Non. Le tableau pages renvoyé conserve exactement la longueur et l’ordre de l’entrée.
Une page notée GRAYSCALE ou entourée d'espaces compte-t-elle comme modifiée ?
Non. Les majuscules et les espaces autour de la valeur sont ignorés, ces pages sont donc reconnues comme déjà en niveaux de gris. Seuls des modes comme color, rgb, cmyk ou monochrome comptent comme un changement.
Que signifie un résultat de zéro page modifiée ?
Que la liste était valide et que toutes les pages étaient déjà en niveaux de gris : il n'y avait rien à changer. Cela ne veut jamais dire que le document était vide, car une liste vide est refusée avec un message clair.
À quoi sert le nombre de pages modifiées ?
À afficher un aperçu du type « 12 pages sur 30 vont changer », à vérifier qu'un document déjà converti ne garde aucune page en couleur ou à repérer les fichiers qui mélangent couleur et gris.
Outils associé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
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/grayscale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pages":["color","grayscale","cmyk"]}'const res = await fetch("https://api.kit.forhosting.com/pdf/grayscale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pages": [
"color",
"grayscale",
"cmyk"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/grayscale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pages": [
"color",
"grayscale",
"cmyk"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/grayscale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pages":["color","grayscale","cmyk"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pages":["color","grayscale","cmyk"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/grayscale", 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
{
"pages": [
"color",
"grayscale",
"cmyk"
]
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.grayscale",
"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 | 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. |
Notes techniques
Interprétez le nombre de pages modifiées
Chaque élément d’entrée valide devient la valeur canonique exacte grayscale. Cette distinction est utile lorsqu’une conversion a déjà eu lieu en amont ou lorsque des documents mixtes proviennent de plusieurs sources. Les valeurs intermédiaires signalent un document mixte. Le champ pages_changed compte uniquement les modes dont la valeur, après suppression des espaces et sans distinction de casse, n’était pas déjà grayscale. Ainsi, grayscale, GRAYSCALE et le même terme entouré d’espaces sont reconnus comme déjà conformes, tandis que color, rgb, cmyk, monochrome ou tout autre mode non vide est compté comme une modification. Le champ page_count correspond toujours au nombre d’éléments fournis et le tableau pages renvoyé conserve cette longueur. Un pages_changed égal à zéro signifie que la requête était valide mais qu’aucune page ne devait changer ; cela ne signifie pas que l’entrée était vide. Une valeur égale à page_count indique que toutes les pages ont changé. Le calcul n’utilise ni réseau, ni horloge, ni hasard, ni règle régionale, ni état mutable : une entrée identique produit donc toujours le même JSON.
Intégrez le résultat à votre traitement PDF
Un moteur PDF peut enfin employer la liste ordonnée renvoyée comme mode cible et enregistrer pages_changed dans un rapport, une validation ou des métriques d’exploitation. L’automatisation coûte $0.002 par requête, sans supplément par page déclaré.
Questions techniques
Que compte pages_changed ?
Ce champ compte chaque page valide dont la valeur, après retrait des espaces et sans distinction de casse, n’était pas grayscale.
Que se passe-t-il si toutes les pages sont déjà en niveaux de gris ?
La requête aboutit, toutes les pages renvoyées restent à grayscale et pages_changed vaut zéro.
Puis-je envoyer un tableau pages vide ?
Non. Une description de PDF doit contenir au moins un mode de page ; une entrée vide ou absente renvoie invalid_input.
Combien coûte une requête automatisée ?
Le tarif publié est de $0.002 par requête, sans supplément par page.