Convertire un PDF in scala di grigi, pagina per pagina
Quattro pagine segnate come colore, grigio, CMYK e grigio tornano come quattro pagine in scala di grigi, con un conteggio che mostra che solo 2 dovevano cambiare. Lo usi per preparare una conversione o scovare file misti. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Pagine
- color, grayscale, CMYK, grayscale
- Pagine
- grayscale, grayscale, grayscale, grayscale
- Numero di pagine
- 4
- Pagine modificate
- 2
Converta un PDF in scala di grigi nella fase dei metadati di pagina con un’operazione semplice e deterministica. Indichi il modo colore corrente di ogni pagina nell’ordine del documento e otterrà un elenco corrispondente in cui tutte le pagine sono marcate come grayscale. Il risultato comunica anche il numero totale di pagine e quanti modi sono cambiati esattamente, distinguendo una conversione completa da un documento già pronto. I documenti vuoti vengono rifiutati con un chiaro errore di input.
Rappresenti il PDF come una sequenza ordinata di modi
Questa capacità utilizza le informazioni sul modo colore di ogni pagina prodotte da una precedente fase di ispezione o elaborazione del PDF. Fornisca una stringa non vuota per ogni pagina, mantenendo lo stesso ordine del documento. Per esempio, un PDF di tre pagine può essere rappresentato da color, grayscale e cmyk.
L’output conserva tre posizioni nello stesso ordine, impostandole tutte su grayscale. Poiché l’operazione agisce sui descrittori di pagina e non sui dati binari caricati, è prevedibile, rapida e semplice da inserire tra l’analisi del PDF e una successiva fase di rendering o esportazione. L’input deve contenere almeno una pagina.
Se il campo pages manca, l’elenco è vuoto, il valore non è un elenco o un modo è privo di testo, la richiesta viene rifiutata invece di essere trattata come un documento valido di zero pagine. Questa convalida rigorosa rende visibili gli errori del flusso ed evita che l’assenza del risultato del parser sembri una conversione riuscita. L’ordine non viene mai riordinato, deduplicato o modificato.
Inserisca il risultato nel flusso di elaborazione PDF
Il risultato è pensato per processi che separano l’ispezione del PDF, la pianificazione della trasformazione e il rendering del file. In primo luogo, un parser o un sistema documentale determina il modo corrente di ogni pagina. Questa capacità normalizza poi il piano e indica quanti descrittori richiedono una modifica.
La capacità non apre, rasterizza, ricolora o restituisce un PDF binario; trasforma la descrizione dei modi per pagina fornita da Lei. Questo confine consente l’uso nel browser e l’automazione deterministica, ma chi deve modificare i pixel deve comunque inoltrare il piano a un renderer PDF appropriato. Il conteggio può alimentare un’anteprima come “12 pagine su 30 cambieranno”, verificare che un documento dichiarato convertito non contenga più modi colore oppure segnalare file sorgente misti inattesi.
Casi d'uso
Preparare un piano di conversione
Normalizzi i modi rilevati prima di inviare al renderer PDF un elenco ordinato di destinazioni in scala di grigi.
Controllare documenti con modi misti
Conti quante pagine di un PDF ricevuto non sono ancora marcate come grayscale.
Verificare una conversione precedente
Confermi che un documento elaborato non richieda altre modifiche senza accettare un risultato vuoto.
Domande frequenti
Questa capacità restituisce un file PDF convertito?
No. Normalizza i descrittori del modo colore forniti. Un renderer PDF successivo deve applicare il modo richiesto ai pixel e alle risorse.
L’ordine delle pagine viene modificato?
No. L’array pages restituito conserva esattamente la lunghezza e l’ordine dell’input.
Una pagina scritta come GRAYSCALE o con spazi in più conta come modificata?
No. Maiuscole e spazi attorno al valore vengono ignorati, quindi quelle pagine risultano già in scala di grigi. Solo modalità come color, rgb, cmyk o monochrome contano come modifica.
Che cosa significa un risultato con zero pagine modificate?
Che l'elenco era valido e tutte le pagine erano già in scala di grigi, quindi non c'era nulla da cambiare. Non significa mai che il documento fosse vuoto: un elenco vuoto viene rifiutato con un messaggio chiaro.
A cosa serve il conteggio delle pagine modificate?
A mostrare un'anteprima come «cambieranno 12 pagine su 30», a verificare che un documento già convertito non abbia più pagine a colori o a segnalare file che mescolano pagine a colori e in grigio.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"pages": [
"color",
"grayscale",
"cmyk"
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.grayscale",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_mb | 25 |
max_pages | 200 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Interpreti il conteggio delle pagine modificate
Ogni elemento valido dell’input diventa il valore canonico esatto grayscale. Di conseguenza, grayscale, GRAYSCALE e lo stesso termine circondato da spazi sono riconosciuti come già conformi, mentre color, rgb, cmyk, monochrome o qualunque altro modo non vuoto viene contato come modifica. Questa distinzione è utile quando la conversione è già avvenuta a monte o quando documenti misti arrivano da più fonti. I valori intermedi identificano documenti con modi misti. Il campo pages_changed conta soltanto i modi il cui valore, dopo la rimozione degli spazi e senza distinzione tra maiuscole e minuscole, non era già grayscale. Il campo page_count corrisponde sempre al numero di elementi forniti e l’array pages restituito mantiene la stessa lunghezza. Un valore pages_changed pari a zero significa che la richiesta era valida ma nessuna pagina doveva cambiare; non indica un input vuoto. Se il valore coincide con page_count, tutte le pagine sono cambiate. Il calcolo non usa rete, orologio, casualità, regole locali o stato mutabile, quindi lo stesso input produce sempre lo stesso JSON.
Inserisca il risultato nel flusso di elaborazione PDF
Infine, un motore PDF può utilizzare l’elenco ordinato restituito come modo di destinazione e registrare pages_changed per report, convalide o metriche operative. L’uso automatizzato costa $0.002 per richiesta, senza un costo aggiuntivo per pagina.
Domande tecniche
Che cosa conta pages_changed?
Conta ogni pagina valida il cui valore, rimossi gli spazi e ignorate maiuscole e minuscole, non era ancora grayscale.
Che cosa accade se tutte le pagine sono già in scala di grigi?
La richiesta riesce, tutte le pagine restituite rimangono grayscale e pages_changed vale zero.
Posso inviare un array pages vuoto?
No. La descrizione di un PDF deve contenere almeno un modo di pagina; un input vuoto o assente restituisce invalid_input.
Quanto costa una richiesta automatizzata?
Il prezzo pubblicato è $0.002 per richiesta, senza costi aggiuntivi per pagina.