For developers

Branded portraits, built into your app.

Turn existing photos into a consistent set of team portraits. Set a background, framing and logo once, then bring portrait preparation directly into your own workflow.

  • Your brand preset, applied to every new batch
  • Private uploads, review and downloadable JPEG or PNG files
  • Standard HTTPS requests, JSON responses and OpenAPI 3.1
Explore API docs Open team workspace
A smiling man wearing glasses and a charcoal polo, photographed against a sage studio background.
From our team portrait examples · AI-generated illustration

One integration, your workflow

Any application. Any platform.

Connect any application or platform that can make HTTPS requests—from web and mobile apps to internal tools and automation services. Use your server or a secure integration service to keep the API key out of browser and mobile clients. No dedicated SDK is required.

Employee onboarding

Collect a new starter’s photo in your HR app, apply the company preset, then add the approved portrait to your staff directory.

Teams and memberships

Give sports clubs, associations and member platforms a consistent set of portraits, including the organisation’s logo.

Profiles at scale

Prepare speaker profiles, franchise directories or customer account images from one shared workflow. Reuse the same look as people join.

Quick integration guide

From a source photo to an approved portrait.

  1. Save your team look

    Create a workspace and API key. Upload your logo, choose a background and output format, and save a default preset in the workspace or through the API.

  2. Create a batch and upload

    Create a batch using your default, or pass a different preset. Upload up to 100 individual photos, each with your own person reference. A background override applies only to that batch.

  3. Process and check progress

    Start processing and poll the batch for each photo’s status. Keep idempotency keys when retrying batch creation or uploads. Show any photo that needs a clearer source or framing correction.

  4. Review and use the results

    Review the private previews and approve ready portraits. Download individual JPEG and PNG files, or prepare a ZIP of approved results, then deliver them through your application.

Create a batch with your saved brand preset

# Use your saved default background, logo and format.
curl -X POST "$PORTRAITDOCK_BASE/portrait-batches" \
  -H "X-API-Key: $PORTRAITDOCK_API_KEY" \
  -H "Idempotency-Key: onboarding-september-01" \
  -H "Content-Type: application/json" \
  -d '{"label":"September starters"}'

Set PORTRAITDOCK_BASE to your API origin plus /api/public/v1, and use a key with images:read and images:write scopes.

Full endpoint referenceIntegration guide for AI coding toolsOpenAPI JSON

Growing beyond a single team

High-volume accounts and pricing

Start with prepaid team credits. For high-volume integrations, tell us your expected monthly photo count, peak batch volume and turnaround needs so we can discuss account capacity and pricing. Individual batches support up to 100 photos.

Contact us for details.

View prepaid pricing