Passfoto-API

Kein API Key. Kein Konto. Keine Anmeldung. Laden Sie ein Foto und einen Ländercode hoch, und Sie erhalten ein korrekt zugeschnittenes Passfoto zurück. Außerdem zeigen wir Ihnen die gemessene Kopfhöhe, damit Sie diese selbst überprüfen können.

Zuletzt aktualisiert: 1. September 2026

Dies ist dieselbe Engine, die PassportNinja-Website läuft. Kostenlos aufrufbar, und es gibt nichts, wofür man sich registrieren muss.

Ein Foto erstellen

$ curl -s -F "file=@portrait.jpg" -F "country=nl" \
    https://passportninja.com/api/photo
{
  "job_id": "041379c97a80",
  "template": "Netherlands, passport/ID (35×45 mm)",
  "photo":     "/api/result/041379c97a80/photo.png",
  "photo_jpg": "/api/result/041379c97a80/photo.jpg",
  "sheet":     "/api/result/041379c97a80/sheet.jpg",
  "size_mm":   [35.0, 45.0],
  "head_mm":   34.2,
  "head_range_mm": [32.0, 36.0],
  "bewaar_min": 45,
  "warnings": []
}

$ curl -s -o passport.png \
    https://passportninja.com/api/result/041379c97a80/photo.png

Die Compliance-Zahlen sind das Wesentliche

Die meisten Passfoto-Tools liefern Ihnen ein zugeschnittenes Foto und überlassen es Ihnen, zu hoffen. Dieses Tool sagt Ihnen, was es getan hat:

`head_mm`	Die tatsächlich erreichte Kopfhöhe in Millimetern.
`head_range_mm`	Der für das jeweilige Land erforderliche Bereich.
`size_mm` / `size_px`	Die Fotogröße in Millimetern und in Pixeln.
`warnings`	Alles, was es wert ist, der Person mitzuteilen, z. B. dass ein Foto so eng gerahmt ist, dass es nicht sauber zugeschnitten werden kann.

Falls head_mm innerhalb head_range_mmDas Bild ist innerhalb der vorgegebenen Parameter. Das ist eine Prüfung, die Sie in Ihrem eigenen Code durchführen können, anstatt sich auf uns zu verlassen.

Druckbögen

Jedes erstellte Dokument kann zudem als ausdruckbare Vorlage heruntergeladen werden. Die entsprechenden Vorlagen finden Sie unter sheets in der Antwort. Im Moment sind das 10 × 15 cm mit 8 Fotos, US Letter mit 25 und A4 mit 30. Rufen Sie das gewünschte ab url Sie wünschen, genau wie bei einem einzelnen Foto.

Länderformate

Aktuell 13 Formate verfügbar. Bitte nicht fest einprogrammieren, sondern abfragen:

$ curl -s https://passportninja.com/api/templates
[{"key":"us","label":"United States, passport & visa (2×2 in)","size_mm":[50.8,50.8]},
 {"key":"nl","label":"Netherlands, passport/ID (35×45 mm)","size_mm":[35.0,45.0]}, ...]

Übertragen Sie key Sie als die country Feld aus, und Sie erhalten die allgemeine Schengen-Größe.

Parameter und Grenzen

Name	Erforderlich	Was es tut
`file`	ja	Das Foto. Eine scharfe, frontal aufgenommene Aufnahme, bei der der ganze Kopf sichtbar ist.
`country`	nein	Ein Schlüssel von `/api/templates`. Standardmäßig wird das allgemeine Schengen-Format verwendet.

Maximale Dateigröße	99 MB
Gleichzeitig ausführen	3 pro IP-Adresse
Anfragen pro Tag	Keine Begrenzung
Das Ergebnis bleibt verfügbar.	45 Minuten oder 24 Stunden mit einem 5-Euro-Pass.

Fehler

Status	Bedeutung
`422`	Kein Gesicht erkannt oder die `file` Ein Feld fehlt. Die Fehlermeldung gibt an, welches.
`413`	Das Foto ist größer als 99 MB.
`429`	Drei Aufträge laufen bereits von dieser Adresse.

Verwendung in Ihrem eigenen Projekt

Bauen Sie darauf auf, auch in etwas, für das Sie Gebühren erheben. Wenn Ihr Projekt auflistet, was es verwendet, ein Link zurück zu passportninja.com das ist es, was dieses Tool kostenlos macht. Planen Sie umfangreiche Projekte? Dann melden Sie sich auf unserem Kontaktseite zuerst.

Fragen

Benötige ich einen API-Schlüssel?

Nein. Kein Schlüssel, kein Konto, keine Registrierung erforderlich.

Wie kann ich sicherstellen, dass das Foto tatsächlich den Anforderungen entspricht?

Die Antwort gibt Ihnen die Informationen. Sie gibt head_mm, die gemessene Kopfhöhe, und head_range_mm, den vom jeweiligen Land geforderten Bereich, zurück. Wenn der erste Wert innerhalb des zweiten liegt, entspricht das zugeschnittene Bild den Vorgaben.

Warum habe ich eine 422-Fehlermeldung erhalten?

Fast immer, weil kein Gesicht erkannt wurde. Verwenden Sie ein frontal aufgenommenes Foto, auf dem der ganze Kopf im Bild ist und nichts die Oberseite des Kopfes abschneidet.

Welche Länder werden unterstützt?

Derzeit 13 Formate, darunter die Vereinigten Staaten, das Vereinigte Königreich, die Niederlande, Indien, China und die allgemeine Schengen-Größe. Rufen Sie GET /api/templates auf, um die aktuelle Liste abzurufen, anstatt sie fest zu codieren.

Was passiert, wenn sich kein Gesicht auf dem Foto befindet?

Sie erhalten eine HTTP-422-Fehlermeldung mit der Information, dass kein Gesicht gefunden wurde. Verwenden Sie ein scharfes, frontal aufgenommenes Foto, auf dem das gesamte Gesicht sichtbar ist.

Wie lange ist die Job-ID gültig?

Nach 45 Minuten werden die Dateien gelöscht. Mit einem ShinobiTools-Abonnement für 5 € Pass Derselbe Auftrag bleibt 24 Stunden lang verfügbar.

Die Bedingungen sind auf der AGB, und was mit Ihrem Foto passiert, steht auf der Datenschutzseite.