ForHosting KIT · Dokumente & PDF

PDF-Farbprofil prüfen: CMYK, RGB oder keines

Diese Prüfung liest einen extrahierten XMP- oder RDF-Block beziehungsweise ein PDF-Metadatenwörterbuch und meldet, ob darin ausdrücklich ein CMYK-Profil, ein RGB-Profil oder kein eingebettetes Farbprofil angegeben ist.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Diese Unterscheidung hilft vor dem professionellen Druck: Eine RGB-Angabe kann auf eine noch erforderliche Konvertierung hinweisen, während ein benanntes CMYK-Ausgabeprofil die vorgesehene Druckbedingung dokumentieren kann. Die Prüfung ist deterministisch, überträgt das PDF nicht an einen anderen Dienst und nennt den Metadatenhinweis, auf dem die Einordnung beruht.

Was die Prüfung feststellt

Ein PDF kann am Bildschirm korrekt aussehen und dennoch Farbinformationen enthalten, die für einen Druckablauf ungeeignet oder mehrdeutig sind. Diese Prüfung beantwortet eine eng umrissene, nachvollziehbare Frage: Bezeichnet der bereitgestellte Metadatenblock ausdrücklich ein CMYK-Profil, ein RGB-Profil oder keine erkannte Profilangabe? Untersucht werden kanonische Begriffe für Farbräume, verbreitete ICC-Profilfamilien und Photoshop-Werte für den Farbmodus in XMP und verwandten Metadaten. Das Ergebnis enthält die Einordnung, einen booleschen Wert zum Fund eines Profils und einen kurzen Beleg für die erkannte Angabe. Ein vollständiger Metadatenblock ohne einschlägige Angabe liefert keines; das ist ein gültiges Ergebnis und kein Fehler. Text, der weder einen vollständigen XMP- oder RDF-Block noch ein serialisiertes PDF-Wörterbuch darstellt, wird dagegen abgelehnt. Fehlende Metadaten stillschweigend als Dokument ohne Profil zu behandeln, würde einen Extraktionsfehler verbergen. Das Werkzeug untersucht ausschließlich Metadaten. Es rendert keine Seiten, prüft nicht jedes Bildobjekt, öffnet keinen OutputIntent-Datenstrom und weist nicht nach, dass alle Seitenelemente den angegebenen Farbraum verwenden.

Metadaten vorbereiten und auswerten

Geben Sie den vollständigen, aus dem PDF extrahierten Metadatenblock einschließlich seiner XMP- oder RDF-Umhüllung an. Alternativ können Sie ein vollständiges PDF-Wörterbuch zwischen doppelten spitzen Klammern bereitstellen. Bewahren Sie Profilnamen und Farbraumfelder unverändert, da sie als Belege für die Einordnung dienen. Ein CMYK-Ergebnis kann aus DeviceCMYK, einem CMYK-Farbmodellwert, dem Photoshop-Farbmodus 4 oder einer erkennbaren Druckprofilfamilie wie FOGRA, SWOP, GRACoL oder ISO Coated folgen. Ein RGB-Ergebnis kann auf DeviceRGB, CalRGB, sRGB, Adobe RGB, Display P3, ProPhoto RGB, ECI RGB, einem RGB-Modellwert oder dem Photoshop-Farbmodus 3 beruhen. Sind beide Familien ausdrücklich vorhanden, lehnt die Prüfung die Eingabe als widersprüchlich ab, statt den zuerst gefundenen Treffer auszuwählen. Verstehen Sie keines wörtlich: Im bereitgestellten Block wurde keine unterstützte Angabe zu einem eingebetteten Profil gefunden. Das bedeutet weder, dass das PDF keine Farben enthält, noch garantiert es eine geräteunabhängige Ausgabe. Die verfügbaren Metadaten weisen lediglich kein einordenbares Profil aus.

Das Ergebnis in der Druckvorstufe verwenden

Betrachten Sie das Ergebnis als ersten Kontrollpunkt und nicht als vollständiges Preflight-Zertifikat. Für Offset- oder Digitaldruck ist ein ausgewiesenes CMYK-Profil häufig ein hilfreiches Zeichen, weil es eine druckbezogene Farbbestimmung dokumentiert. Das richtige Profil hängt jedoch weiterhin von Druckmaschine, Papier, Farbauftrag und regionalem Standard ab. Ein RGB-Ergebnis ist nicht automatisch fehlerhaft: Moderne PDF-Abläufe können RGB-Inhalte erhalten und erst über eine kontrollierte Ausgabebedingung im Rasterprozessor konvertieren. Das Produktionsteam sollte dennoch bestätigen, wo und wie diese Umwandlung erfolgt. Ein Ergebnis ohne Profil verlangt eine dokumentierte Entscheidung. Die Datei kann sich auf Gerätefarben, einen separaten Auftragsschein oder OutputIntent-Daten stützen, die in den extrahierten Metadaten fehlen. Kombinieren Sie diese Prüfung mit Kontrollen von Seitenformat, Beschnitt, eingebetteten Schriften, Bildauflösung, Transparenz, Überdrucken, Sonderfarben und OutputIntent. Speichern Sie bei automatisierter Annahme die Einordnung samt Belegen beim Auftrag, leiten Sie RGB-Dateien oder Dateien ohne Profil zur Prüfung weiter und beschränken Sie eine automatische Ablehnung auf Regeln, die mit dem Druckdienstleister vereinbart wurden. Jede Prüfung per API kostet $0.002.

Anwendungsfälle

Eingehende Druckdateien vorsortieren

Leiten Sie PDFs mit RGB-Angabe oder ohne ausgewiesenes Profil vor Produktionsbeginn an die Druckvorstufe weiter.

Lieferantenkonformität dokumentieren

Erfassen Sie die angegebene Farbfamilie und den zugehörigen Beleg bei jeder eingereichten Werbe- oder Verpackungsdatei.

Uneinheitliche Ausgabe untersuchen

Vergleichen Sie Metadatenangaben verschiedener PDF-Fassungen, wenn Proof und Auflage unerwartete Farbabweichungen zeigen.

Häufige Fragen

Garantiert ein CMYK-Ergebnis die Druckfertigkeit des PDFs?

Nein. Es bestätigt eine CMYK-Angabe in den bereitgestellten Metadaten. Ein vollständiger Preflight muss zusätzlich Seitenobjekte, Ausgabebedingungen, Schriften, Beschnitt, Auflösung und weitere Anforderungen prüfen.

Warum liefert ein gültiger Metadatenblock keines?

Der Block ist strukturell vorhanden, enthält aber keine unterstützte CMYK- oder RGB-Profilangabe. Ein fehlender Block wird dagegen als ungültige Eingabe abgelehnt.

Ist ein RGB-Profil für den Druck immer falsch?

Nein. Manche gesteuerten Abläufe behalten RGB-Daten absichtlich bis zur Ausgabekonvertierung bei. Klären Sie Konvertierungsregeln und Zieldruckbedingung mit dem Druckdienstleister.

Was geschieht bei Angaben zu CMYK und RGB zugleich?

Die Eingabe wird als widersprüchlich abgelehnt, weil die Auswahl nur einer Angabe eine Mehrdeutigkeit verdecken würde, die im Preflight geklärt werden muss.

Liest die Prüfung die vollständige PDF-Datei?

Nein. Sie verarbeitet einen extrahierten XMP- oder RDF-Block beziehungsweise ein PDF-Metadatenwörterbuch. Seiteninhalte und eingebettete ICC-Datenströme in PDF-Bytes werden nicht analysiert.

Was kostet eine Prüfung über die API?

Jede Anfrage kostet $0.002. Die Verarbeitung ist deterministisch und ruft keine externen Dienste auf.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/pdf/color-profile-check

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem 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)

Beispiel-Anfrage

{
  "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>"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.color_profile_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

max_chars 250000

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →