Do I need an API key?

No. No key, no account, no sign-up.

Which countries are supported?

13 formats at the moment, including the United States, the United Kingdom, the Netherlands, India, China and the general Schengen size. Call GET /api/templates for the current list rather than hard-coding it.

How do I know the photo actually complies?

The response tells you. It returns head_mm, the head height it measured, and head_range_mm, the range the country requires. If the first falls inside the second, the crop is within spec.

What happens if there is no face in the photo?

You get HTTP 422 with a message saying no face was found. Use a sharp, front-facing photo with the whole head visible.

How long does the result stay available?

45 minutes without a pass, then the job id stops working and the files are gone. With a EUR 5 ShinobiTools pass the result stays available for 24 hours.

How do I check the result is compliant?

Compare head_mm against head_range_mm in the response. Both are returned on every job.

Almost always because no face was detected. Use a front-facing photo with the whole head in frame and nothing cropping the top of the head.

How long does the job id last?

45 minutes, then the files are deleted. With a €5 ShinobiTools pass the same job stays available for 24 hours.

← Zurück zum Tool

Passfoto-API

Kein API Key. Kein Konto. Keine Anmeldung. Posten Sie ein Foto und einen Ländercode, erhalten Sie ein korrekt beschnittenes Passfoto zurück, plus die Kopfhöhe, die wir gemessen haben, damit Sie es selbst überprüfen können.

Zuletzt aktualisiert: 1. September 2026

Dies ist der gleiche Motor PassportNinja Website läuft. Frei anrufen, und es gibt nichts zu registrieren.

Ein Foto erstellen

$ curl -s -F "[email protected]" -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.

Wenn head_mm Stürze nach innen head_range_mmDie Ernte ist innerhalb der Spec. Das ist eine Überprüfung, die Sie in Ihrem eigenen Code ausführen können, anstatt uns zu vertrauen.

Druckbögen

Jeder Job produziert auch bedruckbare Blätter, aufgeführt unter sheets In der Antwort. Im Moment ist das 10 × 15 cm mit 8 Fotos, US Letter mit 25 und A4 mit 30. Abrufen je nachdem, url Sie wollen, genauso wie das einzelne Foto.

Länderformate

Zum Zeitpunkt der Erstellung 13 Formate. Programmieren Sie diese nicht fest ein, sondern fragen Sie stattdessen:

$ 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]}, ...]

Passieren Sie die key Sie wollen wie die country Feld. Lassen Sie es weg 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`. – Mängel beim allgemeinen Schengen-Format.

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 gefunden, oder die `file` Feld fehlt. Die Botschaft sagt was.
`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 das freihält. Reales Volumen planen? Sag Hallo auf der Kontaktseite zuerst.

Fragen

Benötige ich einen API-Schlüssel?

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

Wie kann ich überprüfen, ob das Ergebnis den Anforderungen entspricht?

Vergleichen head_mm gegen head_range_mm In der Antwort. Beide werden bei jedem Job zurückgegeben.

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.

Wie lange ist die Job-ID gültig?

45 Minuten, dann werden die Dateien gelöscht. Mit einem €5 ShinobiTools Pass Der gleiche Job bleibt 24 Stunden lang verfügbar.

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.

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.

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 sind die Ergebnisse verfügbar?

45 Minuten lang, danach wird die Job-ID deaktiviert und die Dateien sind gelöscht. Mit einem ShinobiTools-Pass für 5 EUR bleiben die Ergebnisse 24 Stunden lang verfügbar.

Die Bedingungen sind auf der Begriffe SeiteWas mit Ihrem Foto passiert, ist auf der Datenschutzseite.

← PassportNinja Home Kontakt Datenschutz Über Bedingungen iPhone HEIC für JPG Teil von ShinobiTools