Release notes

v0.1.0 — Initial release

This is the first public release of the Phota API.

Studio

POST /edit — Edit images using a text prompt and optional profile references. Supports base64 and URL input images.
POST /generate — Generate new images from a text prompt alone, without any input image. Supports profile references for identity preservation.
POST /enhance — Automatically enhance a photo without a text prompt.

Profiles

POST /profiles/add — Create a new profile from – reference image URLs. Training runs asynchronously.
GET /profiles/{profile_id}/status — Poll the training status of a profile (IN_PROGRESS, READY, or ERROR).
GET /profiles/ids — List all profile IDs for the authenticated account.
GET /profiles/{profile_id}/profile_picture — Retrieve a profile picture as a JPEG image.
DELETE /profiles/{profile_id} — Permanently delete a profile and all associated data.

Identity preservation — Train profiles from reference photos and use them across edits and generations. Reference profiles in prompts with the [[profile_id]] syntax to control where specific people appear.
Pro mode — Available on edit and generate endpoints. Enables better instruction following and quality at the cost of higher costs. Unlocks aspect ratio and resolution control.
Multi-image output — Generate up to 4 output images per request.
Flexible input — Accept images as raw base64 strings or publicly accessible URLs.
Aspect ratio and resolution control — Choose from 11 aspect ratios and up to 4K resolution when pro mode is enabled.
Billing metadata — Responses include known_subjects with counts of known subjects generated per profile, used for billing purposes.

⌘I