Skip to main content

​
Welcome to the Phota API

Phota is the API for GenAI-powered photography, specialized to solve the last-mile problem of identity preservation. Generic image models can’t reliably preserve what a specific person looks like. Phota can. By running our proprietary identity-perserving model together with flagship image editing models (such as Nano Banana), Phota API allows you to integrate identity-preserved photo editing, generation, and enhancement into your application. Train a profile from – reference photos of a subject. Then edit, generate, or enhance images where that person is accurately represented — every time. Reference one or more profiles in any request using [[profile_id]] syntax. Base URL: https://api.photalabs.com/v1/phota

​
Capabilities

​
Edit

Provide one or more input images and a text prompt describing the desired transformation. Phota applies the edit while preserving the identity of any known subjects in the photo.
Input photoBefore
Edited outputAfter
”Make [[abc123]] look at the camera and create a portrait shot.”
Input photoBefore
Edited outputAfter
”Combine [[abc123]] from the first image and [[def456]] from the second image in one group shot.”
Input photoBefore
Edited outputAfter
”Convert to a solo portrait of [[abc123]].”
Fix expressions, add or remove people from group shots, adjust camera angle and lighting, clean up artifacts — all while keeping subjects with known profiles accurately represented.

​
Generate

Describe what you want in a text prompt. Reference one or more trained profiles so every generated image looks like the actual person (or pet).
Generated imagePhota
”Artistic Noir Studio Headshot of [[abc123]], chest up. Introspective expression, gaze directed slightly off-camera, subtle three-quarter head tilt.”
Generated imagePhota
”Playful, photorealistic portrait of [[abc123]] and [[def456]], emerging through torn festive paper. Their hands emerge through the torn paper, holding the edges as if the subjects are emerging from the paper.”
Generated imagePhota
”Professional corporate headshot of [[abc123]]. Off-center to the right, smiling at camera, confident expression.”
Great for professional headshots, holiday cards, family portraits, profile pictures, influencer-style shoots in any setting.

​
Enhance

Upload a photo, get a better photo back. No prompt, no configuration. Phota automatically improves lighting, composition, color, and overall photographic quality.
Original photoBefore
Enhanced photoAfter
Original photoBefore
Enhanced photoAfter
Original photoBefore
Enhanced photoAfter
Works on photos with poor lighting, compression artifacts, blur, and other common defects.

​
How profiles work

To preserve someone’s identity, you first create a profile by uploading – reference photos of the same subject. Phota learns their appearance and returns a profile_id you can reference in any request using [[profile_id]] syntax. People and pets (cats and dogs) are supported. Group photos are fine — Phota automatically creates a profile for the subject that appears most often across all uploaded images. The API only considers profiles explicitly passed in each request — if you don’t include any, no identity preservation is applied, even if trained profiles exist in your account. A typical integration looks like this: your user uploads photos of themselves, you train a profile via the API, and then pass that profile in every edit or generation you run for them. Multi-person scenes work too — just reference multiple [[profile_id]] values in a single prompt.

Learn more about profiles

Understand the full profile creation process, prompt syntax, and image requirements.

​
Get started

Authentication

Learn how to authenticate your API requests with an API key.

Use cases

See detailed examples of Edit, Generate, and Enhance with code snippets.

API reference

Explore every endpoint, request schema, and response format.

Profiles guide

Deep-dive into profiles, identity preservation, and the [[profile_id]] syntax.

Release notes

See what’s new and what’s changed.