Let AI agents order professional headshots on behalf of humans
HeadshotsByAI provides agent-friendly workflows for individual and team headshots. Agents trigger secure payment links and guide delivery — no manual ops required.
POST /v1/headshot-requests HTTP/1.1Host: api.headshotsbyai.comContent-Type: application/json{"owner": { "name": "Jane", "email": "jane@acme.co" },"preferences": {"package": "standard","styles": ["Grey", "Office", "Outdoor"]},"inputs": { "upload_link_required": true }}
Integrate in minutes
Whether you're a developer or an AI agent, download these spec files to learn how to create headshot requests via our API.
Built for agentic tools
Integrate with any AI system that can call APIs. HeadshotsByAI works with popular agentic frameworks and custom orchestration stacks.
From agent request to delivered headshots
A fully automated pipeline where agents handle the logistics and humans stay in control of payment and photos.
POST /v1/headshot-requests{ "type": "individual" }Agent creates request
The AI agent calls the HeadshotsByAI API to create a headshot request with package selection and owner email.
Owner gets payment link
HeadshotsByAI generates a secure, tokenized payment link and sends it to the human owner via email.
Photos uploaded
After payment, the owner uploads 1–5 selfies through a simple no-login portal. No account required.
AI generates headshots
Our AI model trains on the uploaded photos and generates professional headshots in under 10 minutes.
Results delivered
Download links are sent to both the owner and returned to the agent. Everyone gets what they need.
Purpose-built for agentic workflows
Every part of HeadshotsByAI is designed so AI agents can operate autonomously while keeping humans in control.
Agent-First Workflow
Agents can draft requests, trigger payment links, and receive delivery updates — all without human back-and-forth.
Human Consent & Payment
The owner always pays and approves. Agents never impersonate the human or bypass the checkout flow.
Team & Individual Ready
One unified workflow for individual headshots or team requests, with a tokenized owner invite portal.
Two paths, one seamless experience
Whether ordering for one person or an entire team, the agent-driven flow keeps things simple.
Individual Flow
Agent creates a headshot request with package selection
HeadshotsByAI issues a secure payment link for the human owner
Human uploads 1–5 photos (no login required)
Payment confirms and headshots generate automatically
Delivery links are returned to the agent and owner
Team Flow
Agent creates a team request with company details and seats
HeadshotsByAI returns a secure team payment link for the company owner
Owner completes payment and opens a tokenized owner portal
Owner invites team members by email from the public portal
Invited members upload photos and receive consistent team headshots
