Verifichi il profilo colore PDF: CMYK, RGB o nessuno
Questo strumento legge un blocco XMP, RDF o un dizionario di metadati estratto dal PDF e indica se dichiara esplicitamente un profilo CMYK, un profilo RGB oppure nessun profilo incorporato.
Esegui gratis nel browser
La distinzione è utile prima della stampa professionale: una dichiarazione RGB può segnalare che occorre ancora una conversione, mentre un profilo di output CMYK identificato può documentare la condizione di stampa prevista. La verifica è deterministica, non invia il PDF a servizi esterni e spiega quale indizio nei metadati ha determinato la classificazione.
Che cosa accerta lo strumento
Un PDF può apparire corretto sul monitor e contenere comunque informazioni cromatiche inadatte o ambigue per il flusso di stampa. Questo controllo risponde a una domanda circoscritta e verificabile: il blocco di metadati fornito identifica esplicitamente un profilo CMYK, un profilo RGB oppure non contiene alcuna dichiarazione riconosciuta? La ricerca comprende termini canonici degli spazi colore, famiglie comuni di profili ICC e valori della modalità colore di Photoshop presenti in XMP e nei metadati correlati. Il risultato include la classificazione, un valore booleano che segnala se è stato trovato un profilo e una breve prova della dichiarazione rilevata. Un blocco completo privo di dichiarazioni pertinenti restituisce nessuno; è un risultato valido, non un errore. Viene invece rifiutato un testo che non costituisca un blocco XMP o RDF completo né un dizionario PDF serializzato, perché interpretare metadati mancanti come assenza di profilo nasconderebbe un errore di estrazione. Lo strumento analizza solo i metadati. Non esegue il rendering delle pagine, non controlla ogni oggetto immagine, non apre un flusso OutputIntent e non dimostra che tutti gli elementi usino lo spazio dichiarato.
Come preparare e interpretare i metadati
Fornisca il blocco di metadati completo estratto dal PDF, compreso il contenitore XMP o RDF, oppure un dizionario PDF completo racchiuso tra doppie parentesi angolari. Mantenga invariati i nomi dei profili e i campi degli spazi colore, poiché costituiscono le prove usate per la classificazione. Un risultato CMYK può derivare da DeviceCMYK, da un valore di modello CMYK, dalla modalità colore 4 di Photoshop oppure da una famiglia riconoscibile di profili di stampa come FOGRA, SWOP, GRACoL o ISO Coated. Un risultato RGB può derivare da DeviceRGB, CalRGB, sRGB, Adobe RGB, Display P3, ProPhoto RGB, ECI RGB, da un valore di modello RGB o dalla modalità colore 3 di Photoshop. Se entrambe le famiglie sono presenti in modo esplicito, lo strumento rifiuta l’input come contraddittorio invece di scegliere la prima corrispondenza. Interpreti nessuno alla lettera: nel blocco fornito non è stata trovata alcuna dichiarazione supportata di profilo incorporato. Ciò non significa che il PDF sia privo di colore e non garantisce un output indipendente dal dispositivo; indica solo che i metadati disponibili non dichiarano un profilo classificabile.
Come usare il risultato nella verifica prestampa
Consideri il risultato un controllo preliminare, non un certificato completo di preflight. Nella stampa offset o digitale, un profilo CMYK dichiarato è spesso un segnale utile perché documenta una condizione orientata alla macchina da stampa, ma il profilo corretto dipende comunque dalla stampante, dalla carta, dai limiti d’inchiostro e dalla norma regionale. Un risultato RGB non è automaticamente un difetto: i flussi PDF moderni possono mantenere contenuti RGB e convertirli mediante un intento di output controllato nel processore raster. Il reparto di produzione deve tuttavia confermare dove e come avverrà la conversione. L’assenza di un profilo richiede una decisione documentata. Il file può dipendere dal colore dispositivo, da una commessa separata o da dati OutputIntent non inclusi nei metadati estratti. Abbini questo controllo alla verifica di formato pagina, abbondanza, incorporamento dei font, risoluzione, trasparenze, sovrastampa, tinte piatte e OutputIntent. Nell’acquisizione automatica, conservi classificazione e prove insieme al lavoro, inoltri i file RGB o senza profilo alla revisione e riservi il rifiuto automatico alle regole concordate con il fornitore di stampa. Tramite API, ogni verifica costa $0.002.
Casi d'uso
Selezionare i file in ingresso
Invii i PDF con RGB o senza profilo dichiarato alla revisione prestampa prima di iniziare la produzione.
Documentare la conformità del fornitore
Registri la famiglia cromatica dichiarata e la prova corrispondente accanto a ogni file pubblicitario o di imballaggio ricevuto.
Analizzare risultati incoerenti
Confronti le dichiarazioni nei metadati tra versioni del PDF quando prove e stampe finali mostrano variazioni cromatiche inattese.
Domande frequenti
Un risultato CMYK garantisce che il PDF sia pronto per la stampa?
No. Conferma una dichiarazione CMYK nei metadati forniti, ma un preflight completo deve controllare anche oggetti di pagina, intenti di output, font, abbondanza, risoluzione e altri requisiti.
Perché un blocco di metadati valido restituisce nessuno?
Il blocco è strutturalmente presente, ma non contiene una dichiarazione supportata di profilo CMYK o RGB. Un blocco mancante viene invece rifiutato come input non valido.
Un profilo RGB è sempre sbagliato per la stampa?
No. Alcuni flussi gestiti mantengono intenzionalmente i dati RGB fino alla conversione di output. Confermi con lo stampatore la politica di conversione e la condizione di stampa prevista.
Che cosa accade se compaiono dichiarazioni CMYK e RGB?
L’input viene rifiutato come contraddittorio, perché scegliere una dichiarazione nasconderebbe un’ambiguità da risolvere durante il preflight.
Lo strumento legge l’intero file PDF?
No. Accetta un blocco XMP, RDF o un dizionario di metadati PDF già estratto. Non analizza il contenuto delle pagine né decodifica i flussi ICC incorporati nei byte.
Quanto costa una verifica tramite API?
Ogni richiesta costa $0.002. L’elaborazione è deterministica e non richiama servizi esterni.
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/color-profile-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"metadata":"<x:xmpmeta xmlns:x=\"adobe:ns:meta/\"><rdf:RDF><rdf:Description photoshop:ICCProfile=\"U.S. Web Coated (SWOP) v2\" photoshop:ColorMode=\"4\"/></rdf:RDF></x:xmpmeta>"}'const res = await fetch("https://api.kit.forhosting.com/pdf/color-profile-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"metadata": "<x:xmpmeta xmlns:x=\"adobe:ns:meta/\"><rdf:RDF><rdf:Description photoshop:ICCProfile=\"U.S. Web Coated (SWOP) v2\" photoshop:ColorMode=\"4\"/></rdf:RDF></x:xmpmeta>"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/color-profile-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"metadata": "<x:xmpmeta xmlns:x=\"adobe:ns:meta/\"><rdf:RDF><rdf:Description photoshop:ICCProfile=\"U.S. Web Coated (SWOP) v2\" photoshop:ColorMode=\"4\"/></rdf:RDF></x:xmpmeta>"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/color-profile-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"metadata":"<x:xmpmeta xmlns:x=\\"adobe:ns:meta/\\"><rdf:RDF><rdf:Description photoshop:ICCProfile=\\"U.S. Web Coated (SWOP) v2\\" photoshop:ColorMode=\\"4\\"/></rdf:RDF></x:xmpmeta>"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"metadata":"<x:xmpmeta xmlns:x=\"adobe:ns:meta/\"><rdf:RDF><rdf:Description photoshop:ICCProfile=\"U.S. Web Coated (SWOP) v2\" photoshop:ColorMode=\"4\"/></rdf:RDF></x:xmpmeta>"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/color-profile-check", 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
{
"metadata": "<x:xmpmeta xmlns:x=\"adobe:ns:meta/\"><rdf:RDF><rdf:Description photoshop:ICCProfile=\"U.S. Web Coated (SWOP) v2\" photoshop:ColorMode=\"4\"/></rdf:RDF></x:xmpmeta>"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.color_profile_check",
"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_chars | 250000 |
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. |