REST API v1.0

Iris Photo Processing API

Integrate powerful AI-driven iris photo processing into your applications. Automatically detect, crop, enhance, and upscale iris images in 30 seconds.

curl request
# Upload an iris photo for processing
curl -X POST https://eye.photo/api/photos \
  -H "Authorization: Token YOUR_API_KEY" \
  -F "photo[original_image]=@./eye_image.jpg" \
  -F "photo[callback_url]=https://your-app.com/webhook"
30 seconds
Processing time
Up to 4K
Output resolution
99.9% Uptime
API availability
Secure
Token authentication

How the API Works

Simple integration with powerful results. Our API handles the complex image processing so you don't have to.

1

Upload Photo

Send your eye photo via POST request. Supports RAW, JPG, PNG formats up to 100MB.

2

AI Detection

Our AI automatically detects and precisely crops the iris from your photo.

3

Enhancement

Advanced AI enhances details, removes noise, and upscales to stunning quality.

4

Webhook Callback

Receive the processed image via webhook when ready. No polling needed.

API Features

Everything you need to build amazing iris photography experiences.

Smart Iris Detection

AI-powered detection finds the iris in any eye photo, regardless of angle or lighting conditions.

AI Enhancement

Advanced neural networks enhance details, remove noise, and bring out the natural beauty of each iris.

4K Upscaling

Upscale processed images to stunning 4K resolution for print-quality results.

RAW File Support

Process professional RAW files (.CR2, .CR3, .NEF, .ARW, .DNG) directly for maximum quality.

Webhook Callbacks

Real-time status updates and results delivered directly to your application via webhooks.

Custom Metadata

Pass custom metadata with your requests that gets returned in callbacks for easy tracking.

Build your complete iris workflow

Connect photo processing, customer workflows and artwork creation through one studio-scoped API.

POST

Create and process photos

Detect, crop and enhance an iris photo asynchronously.

file
RAW · JPEG · PNG ≤ 100 MB
raw
CR2 · CR3 · NEF · ARW · DNG
customer
name · email · phone
idempotency_key
string
allow_duplicate
boolean
POST

Large file upload

Upload larger files directly to storage before processing.

file
filename · content_type · byte_size
checksum
Base64 MD5
direct_upload
> 32 MB
upload_limit
150 MB
returns
signed_id · upload target
CONFIG

Custom image output

Configure the appearance and dimensions of the processed iris.

padding
0–50%
pupil_size · soft_edges · vignette
0–100%
image_size
1024–4096 px
background_color
HEX · RGB
defaults
0
GET

Photo status and results

Read processing progress and retrieve completed images.

status
queued → processing → finished / error
metadata
id · timestamps · side · color
result
full resolution
preview
JPEG ≤ 512 × 512 px
poll_interval
5–10 s
POST

Connected customer records

Attach customers to photos or find their studio profile.

lookup
email | phone
email
case-insensitive
phone
normalized digits
scope
studio
returns
id · profile link
POST

Replace edited results

Make an externally edited image the photo’s active result.

file
PNG · JPEG
input
signed_id
original_result
preserved
editor_adjustments
reset → 0
preview
async
GET

Art API: template discovery

Discover system and custom templates available to your studio.

templates
system · custom
metadata
id · name · preview
eye_count
integer
download_sizes
width · height
formats
PNG · JPEG
POST

Art API: render artwork

Combine processed irises into a published art template.

input
template_id · ordered photo_ids
size
1–10,000 px / side
format
PNG (alpha) · JPEG (white)
unify_pupil_size
boolean
idempotency_key
string
GET

Art API: render status and downloads

Track artwork processing and retrieve temporary downloads.

status
queued → processing → completed / failed
result
download · dimensions · MIME · bytes · checksum
error
code · message
download_ttl
15 min
retention
24 h
WEBHOOK

Completion webhooks

Receive success or failure notifications for photos and artwork.

events
photo · art / success · failure
payload
result | error
metadata
JSON
authentication
optional shared secret
delivery
async

The Art Rendering API is available by request as an optional paid add-on. Contact Eye.photo for availability, pricing and activation for your studio; it is not included with standard API access.

Contact Sales

Full endpoint URLs, request examples and integration instructions are available after signing in. API access is scoped to your studio and its permissions.

Ready to Integrate?

Start your free trial today and begin building amazing iris photography experiences with our API.

Full access to all features • Cancel anytime