Geen API sleutel. Geen rekening. Geen aanmelding. Plaats een foto en een landcode, krijg een correct bijgesneden paspoortfoto terug, plus de hoofdhoogte die we gemeten, zodat u het zelf kunt controleren.
Laatst bijgewerkt: 1 september 2026
Dit is dezelfde motor de PassportNinja website Loopt door. Vrij om te bellen, en er is niets om voor te registreren.
$ 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.pngDe meeste tools voor pasfoto's geven je een bijgesneden foto en laten je hopen dat het goed is. Deze tool laat je zien wat hij heeft gedaan:
head_mm | De werkelijke hoogte van het hoofd in millimeters. |
|---|---|
head_range_mm | Het bereik dat het betreffende land vereist. |
size_mm / size_px | De fotogrootte in millimeters en in pixels. |
warnings | Alle informatie die nuttig is om aan de gebruiker te verstrekken, zoals een foto die te strak is ingekaderd om netjes bij te kunnen snijden. |
Als head_mm valt binnen head_range_mm, het gewas is binnen spec. Dat is een controle die je in je eigen code kunt uitvoeren in plaats van ons te vertrouwen.
Elke baan produceert ook drukbare vellen, vermeld onder sheets in het antwoord. Dat is nu 10×15 cm met 8 foto's, US Letter met 25, en A4 met 30. Wat dan ook ophalen url Je wilt, op dezelfde manier als de enkele foto.
Op het moment van schrijven zijn er 13 formaten beschikbaar. Programmeer ze niet hard in, vraag het op:
$ 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]}, ...]Geef de key U wilt als de country veld. Laat het eruit en je krijgt de algemene Schengen grootte.
| Naam | Vereist | Wat het doet |
|---|---|---|
file | ja | De foto. Een scherpe foto van voren, waarop het hele hoofd zichtbaar is. |
country | nee | Een sleutel van /api/templates. Standaardwaarden voor het algemene Schengenformaat. |
| Maximale bestandsgrootte | 99 MB. |
|---|---|
| Gelijktijdig uitvoeren | 3 per IP-adres |
| Verzoeken per dag | Geen limiet |
| Het resultaat blijft beschikbaar | 45 minuten, of 24 uur met een abonnement van €5 |
| Status. | Betekenis |
|---|---|
422 | Geen gezicht gevonden, of de file Het veld ontbreekt. De boodschap zegt welke. |
413 | De foto is groter dan 99 MB. |
429 | Er zijn al drie taken actief vanaf dit adres. |
Bouw erop, ook in iets waarvoor je rekent. Als uw project weergeeft wat het gebruikt, een link terug naar passportninja.com Dat houdt dit vrij. Echt volume plannen? Zeg hallo op de contact pagina Eerst.
Nee. Geen sleutel, geen account, geen registratie nodig.
Vergelijken head_mm tegen head_range_mm in het antwoord. Beiden komen terug bij elke klus.
Bijna altijd omdat er geen gezicht is gedetecteerd. Gebruik een foto van voren met het hele hoofd in beeld en zorg ervoor dat er niets het bovenste deel van het hoofd afsnijdt.
45 minuten, dan worden de bestanden verwijderd. Met een € 5 ShinobiTools pass Dezelfde baan blijft 24 uur beschikbaar.
Momenteel 13 formaten, waaronder de Verenigde Staten, het Verenigd Koninkrijk, Nederland, India, China en het algemene Schengen-formaat. Roep GET /api/templates aan voor de actuele lijst in plaats van deze hard te coderen.
Het antwoord geeft dit aan. Het geeft head_mm weer, de hoogte van het hoofd die is gemeten, en head_range_mm, de hoogte die het land vereist. Als de eerste waarde binnen de tweede waarde valt, voldoet de uitsnede aan de specificaties.
U ontvangt een HTTP 422-foutmelding met de tekst dat er geen gezicht is gevonden. Gebruik een scherpe foto van voren met het hele gezicht zichtbaar.
45 minuten zonder abonnement, daarna stopt de taak-ID met werken en zijn de bestanden verdwenen. Met een EUR 5 ShinobiTools-abonnement blijft het resultaat 24 uur beschikbaar.
Voorwaarden termen pagina, en wat er gebeurt met uw foto is op de Privacypagina.