Automatic face alignment
Position and crop the face according to output dimensions, head size, and eye-line requirements.
Passport / Visa / ID · API
ID Photo API
SaaS service.
Turn portraits into passport, visa, and ID photos with one API. Background removal, precise cropping, and photo checks, ready to integrate.
Read the API DocsFor photo apps, travel platforms, and identity workflows.
Portrait → Passport
US / Sample
Original
Input portrait972 × 778 px
US passport
2 × 2 in600 × 600 px
✓ Background adjusted
✓ Face position aligned
✓ Output dimensions applied
POST /v2/makeIdPhoto
Example output
All-in-one APIOne call, full pipeline
Background removalClean cutout from any backdrop
Crop & complianceFace-aligned crop with spec checks
Pre-built specs150+ passport, visa & ID formats
01 / Photo processing
From portrait to specification.
A focused pipeline for the details that matter: face position, background, image quality, and output size.
Background processing
Replace the original background while preserving natural edges around hair, clothing, and facial details.
Photo quality checks
Identify common issues such as a tilted or turned head, uneven lighting, poor brightness or sharpness, eyeglasses, or a non-neutral expression.
Flexible delivery
Receive the final image in the API response, through a temporary URL, or as a print-ready layout.
Need a format that is not listed? We can help create a custom photo specification for your use case.
Talk to us about a custom specification02 / Sample results
One portrait. Multiple document formats.
Compare original portraits with prepared sample outputs. Switch the document type to explore the crop and dimensions.
Original photoInput
Processed sampleOutput
Photo specification
- Document
- US Passport
- Physical size
- 2 × 2 in
- Pixel size
- 600 × 600 px
- DPI
- 300
- Background
- White
✓ Face detected
✓ Position checked
✓ Dimensions applied
Want to build this into your product?Generate the same result through the API.
Built for a fast integration
One endpoint.
Your entire photo workflow.
Send a portrait and document specification, then receive a correctly cropped, processed, and sized photo for your product.
Authentication, parameters, issue codes, and complete response schemas are maintained in the API documentation.
Server-side requestJSON
POST /v2/makeIdPhoto
{
"apiKey": "••••••",
"apiSecret": "••••••",
"imageBase64": "...",
"specCode": "us-passport",
"outputFormat": "IMAGE_BASE64"
}● 200 OK
"issues": []03 / Document specifications
One API. 150+ photo specifications.
Generate passport, visa, identity, driver's license, and application photos for countries and regions around the world.
Specification data can be queried through the API, so your product can display supported document types dynamically.
View all photo specificationsSpecificationus-passport
Available
Physical size2 × 2 in
Pixel dimensions600 × 600 px
DPI300
Background White
ExpressionNeutral
04 / Use cases
A photo API.
Many ways to put it to work.
From consumer-facing photo apps to high-volume organizational workflows, use the same API foundation and adapt the experience to your product.
01
Passport and visa photo apps
Launch a customer-facing photo product with direct generation or a watermarked preview workflow.
02
Travel and visa platforms
Help customers prepare correctly sized photos and identify common photo-quality problems before submission.
03
Photo studios and retailers
Automate background processing, cropping, sizing, and printable photo-sheet generation at scale.
04
HR and identity systems
Standardize employee badge and profile photos across onboarding, directory, and access-management workflows.
Privacy-conscious by design
Choose how images are delivered and stored.
Identity photos are sensitive. IDPhoto.ai supports workflows designed to reduce unnecessary image retention and give businesses greater control over delivery.
Read our Data Privacy policyBase64 delivery
Receive the generated image as Base64 data without storing the photo on our service.
Temporary URL delivery
Use temporary AWS S3 delivery, with documented retention ranging from 2 hours to 14 days.
Regional endpoints
Use US or EU API endpoints, with other regional deployment options available on request.
Data protection
Data is encrypted during transmission. Our documented practices address GDPR and CCPA requirements.
More from IDPhoto.ai
Extend your photo workflow.
Use focused APIs and services alongside the complete ID photo workflow.
Batch ID Photo Generation
Process large groups of portraits for organizations, events, schools, or employee directories.
Explore batch generation →UK Passport Photo Code API
Generate UK passport photos and supported digital photo-code workflows through an API.
Explore UK photo codes →Background Removal API
Use background removal independently when you do not need the complete ID photo workflow.
Explore background removal →Photo Enhancement API
Improve image clarity and visual quality before using photos in professional workflows.
Explore photo enhancement →Frequently asked questions
What you need to know before integrating.
Still have a question or a custom requirement?
Contact support@idphoto.aiWhat photo formats does the API support?
IDPhoto.ai supports more than 150 photo specifications, including passport, visa, ID, driver's license, and application-photo formats from countries around the world. You can query the available specification codes through the API.
Can you add a custom photo specification?
Yes. If the format you need is not currently available, contact us with the required dimensions, crop, background, and validation rules. We can review the specification for your use case.
How do I get an API key?
Create or access your account in the IDPhoto.ai Dashboard. Your API credentials and account usage are managed separately from this website.
Is a free trial available?
Yes. Create an account in the Dashboard to check the currently available trial access and account quota.
Are uploaded photos stored?
You can request Base64 output for a workflow that stores no images on our service. URL-based output uses temporary AWS S3 storage, with documented retention ranging from 2 hours to 14 days.
What should the input photo look like?
For the best result, provide a clear, front-facing portrait with the face and upper body visible. Avoid strong shadows, blur, extreme head angles, or obstructions around the face.
Does the API guarantee that a photo will be accepted?
The API formats photos according to the selected specification and reports detectable quality issues. Final acceptance is determined by the relevant government agency, application platform, or reviewing authority.
Which API regions are available?
US and EU API endpoints are currently documented. Other regional deployment options may be available for enterprise requirements.
How is pricing determined?
Pricing depends on usage volume and workflow requirements. Start with a trial account in the Dashboard or contact us for volume pricing and custom deployment needs.
Start building
Your next integration.
Picture it here.
Create your API credentials in the Dashboard, then follow the documentation to generate your first photo.
Need help with volume pricing, custom specifications, or regional deployment? Contact support@idphoto.ai