No hay clave de API. Sin cuenta. No hay registro. Publique una foto y un código de país, obtenga una foto de pasaporte correctamente recortada, más la altura de la cabeza que medimos para que pueda comprobarlo usted mismo.
Última actualización: 1 de septiembre de 2026
Este es el mismo motor Sitio web de PassportNinja sigue adelante. Libre de llamar, y no hay nada para registrarse.
$ 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.pngLa mayoría de las herramientas para fotos de pasaporte te ofrecen un recorte y te dejan esperando. Esta herramienta te indica lo que hizo:
head_mm | La altura de la cabeza que realmente produjo, en milímetros. |
|---|---|
head_range_mm | El rango que exige el país. |
size_mm / size_px | El tamaño de la foto en milímetros y en píxeles. |
warnings | Cualquier cosa que valga la pena comunicarle a la persona, como una foto con un encuadre demasiado ajustado para recortarla correctamente. |
Si head_mm cae dentro head_range_mm, la cosecha está dentro de la especificaciones. Ese es un cheque que puedes ejecutar en tu propio código en lugar de confiar en nosotros.
Cada trabajo también produce hojas imprimibles, enumeradas bajo sheets en la respuesta. Ahora mismo que es 10×15 cm con 8 fotos, Carta de EE.UU. con 25, y A4 con 30. Coge lo que sea. url lo mismo que la foto.
13 formatos disponibles al momento de escribir esto. No los codifique directamente, pregunte:
$ 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]}, ...]Pase el key quieres como country campo. Déjalo afuera y consigues el tamaño general de Schengen.
| Nombre | Obligatorio | Función |
|---|---|---|
file | sí | La foto. Una imagen nítida, tomada de frente, con toda la cabeza visible. |
country | no | Una llave de /api/templatesDefaults to the general Schengen format. |
| Tamaño máximo de archivo | 99 MB |
|---|---|
| Ejecuciones simultáneas | 3 por dirección IP |
| Solicitudes por día | Sin límite |
| El resultado permanece disponible | 45 minutos, o 24 horas con un pase de 5 €. |
| Estado | Significado |
|---|---|
422 | No hay rostro encontrado, o file el campo está desaparecido. El mensaje dice qué. |
413 | La foto supera los 99 MB. |
429 | Ya hay tres trabajos en curso desde esta dirección. |
Construye en él, incluyendo en algo que cobras. Si su proyecto enumera lo que utiliza, un enlace de vuelta a passportninja.com es lo que mantiene esto libre. ¿Planeando volumen real? Saluda. página de contacto primero.
No. No se requiere clave, cuenta ni registro.
Compare head_mm contra la head_range_mm en la respuesta. Ambos son devueltos en cada trabajo.
Casi siempre es porque no se detectó ningún rostro. Utilice una foto frontal con toda la cabeza en el encuadre y sin que nada corte la parte superior de la cabeza.
45 minutos, luego se eliminan los archivos. Con 5 € ShinobiTools paso el mismo trabajo permanece disponible durante 24 horas.
13 formatos en este momento, incluidos los Estados Unidos, el Reino Unido, los Países Bajos, la India, China y el tamaño Schengen general. Consulte GET /api/templates para obtener la lista actual en lugar de codificarla.
La respuesta se lo indica. Devuelve head_mm, la altura de la cabeza que midió, y head_range_mm, el rango que requiere el país. Si el primero se encuentra dentro del segundo, el recorte está dentro de las especificaciones.
Recibirá un error HTTP 422 con un mensaje que indica que no se encontró ningún rostro. Utilice una foto nítida y frontal con toda la cabeza visible.
45 minutos sin un pase, luego el ID del trabajo deja de funcionar y los archivos desaparecen. Con un pase de 5 EUR de ShinobiTools, el resultado permanece disponible durante 24 horas.
Los términos están en términos página, y lo que le pasa a su foto está en página de privacidad.