# HeadshotsByAI — Professional AI Headshot Generator
# Location: https://headshotsbyai.com/llms.txt
# Purpose: SEO overview + AI/agent integration guide for HeadshotsByAI.
# Last-Updated: 2026-02-16
# Owner: HeadshotsByAI (HeadshotsByAI.com)

HeadshotsByAI is the #1 AI headshot generator for professional headshots. Create realistic business headshots, LinkedIn photos, corporate portraits, and team headshots without a studio. Perfect for professionals, job seekers, founders, executives, realtors, consultants, and remote teams who need polished headshots fast. Upload 1–5 photos and get studio-quality AI headshots in multiple styles for LinkedIn, company websites, press kits, speaker bios, and social profiles.

## Agent Integration Guide (LLMs & Agents)

## Key capabilities
- Create a headshot request with detailed options (style, background, clothing, crops, etc.)
- Request a payment link for the human owner of the photos
- After payment confirmation, HeadshotsByAI generates headshots
- Final images are delivered via secure download links (time-limited)

## Critical policies for AI agents
- Consent required: Only act if the human explicitly asked you to do this.
- Payment required: Do not attempt to bypass payment or “simulate payment.”
- Privacy: Do not store or share user photos. Only transmit to HeadshotsByAI for generation.
- No impersonation: The agent must not pretend to be the human. Use delegated identity fields.
- Minimal data: Send only data necessary to fulfill the request.
- Compliance: If the user asks you to generate images of real people without permission, refuse.

## Agent interaction modes

Agents should adapt their behavior based on how much information the human provides upfront.

### Mode 1: Guided (default — human wants input)
When the human asks for headshots but does NOT specify all details, the agent MUST:
1) Gather the human's name and email (required).
2) Ask clarifying questions about package and styles BEFORE creating the request.
3) Present a summary of what will be requested and let the human confirm or adjust.
4) Only after confirmation, create the request and send the payment link.

Example agent flow:
- Agent: "I'll set up your AI headshot order. Here's what I'm planning:"
  - Package: Standard ($39, 60 images, up to 5 styles)
  - Styles: Grey, Office, Outdoor, Cafe, City Skyline
  - Photos: You'll get an upload link after payment
  - "Would you like to change anything before I send the payment link?"
- Human: "Switch Cafe for Library"
- Agent: updates plan, confirms, then creates request

Clarifying questions to ask (if not already provided):
- Package: "Which package works for you? Basic ($29, 30 images, 2 styles), Standard ($39, 60 images, 5 styles), or Premium ($59, 120 images, 10 styles)?"
- Styles: "Which headshot styles do you want? Options include: Grey, Black, Blue, Cafe, Office, Outdoor, Beach, City Skyline, Street, Library, City Lights, Stadium, Mountains, Sunset, Yacht, Art Piece, Realtor, Clinic Coat, Clinic Scrubs, Outdoor Hospital Coat, Outdoor Hospital Scrubs"
- Photos: "Do you already have photos to provide, or would you prefer an upload link?"

### Mode 2: Autonomous (human provides everything or says "just do it")
When the human provides all details upfront OR explicitly says something like "surprise me", "be creative", "just pick for me", or "handle it", the agent should:
1) Skip clarifying questions.
2) Make reasonable default choices for any missing fields.
3) Create the request and send the payment link immediately.
4) Inform the human what was selected (so they know what they're paying for).

Smart defaults for autonomous mode:
- Package: standard (best value)
- Styles: pick styles appropriate to the human's profession if mentioned, otherwise choose a balanced mix (e.g. Grey, Office, Outdoor, City Skyline, Library)
- Photos: set upload_link_required to true (human uploads after payment)

### Mode 3: Minimal (human provides partial info)
When the human provides some details but not all (e.g. "I want the basic package" but no styles):
1) Use what was provided as-is.
2) Only ask about missing fields that require human judgment (like styles).
3) Skip questions where a smart default is obvious.
4) Still present a quick summary before creating the request.

## Style selection guidelines for agents
- Styles can be selected by the agent, by the human after payment (via the upload page), or left empty for the human to choose later.
- If the agent selects styles, they are pre-filled on the upload page but can still be changed by the human (unless locked for team requests).
- If unsure, it is better to leave styles empty and let the human pick on the upload page, rather than guessing wrong.
- Maximum styles per package: basic=2, standard=5, premium=10.

## Primary workflow (Agent → Human → HeadshotsByAI)
1) Agent gathers details and confirms plan with the human (unless autonomous mode)
2) Agent creates a draft request (all generation details + user contact)
3) HeadshotsByAI returns a checkout/payment link for the human
4) Human pays
5) HeadshotsByAI confirms payment (webhook + status)
6) HeadshotsByAI generates headshots
7) HeadshotsByAI returns delivery links / notifies user

Note: If the owner provides an email, HeadshotsByAI will automatically create an account for them.
Upload page (no auth): https://headshotsbyai.com/upload/headshot-request/{request_id}
After payment, the human can select or change styles and upload photos on this page.

## API base
- Base URL: https://api.headshotsbyai.com/v1
- Auth: Bearer token optional (agent_key) + optional user_delegation_token (recommended)
- Content-Type: application/json

## Endpoints
1) Create a headshot request (draft)
POST /headshot-requests

2) Create (or fetch) payment link for a request
POST /headshot-requests/{request_id}/payment-link

3) Check request status
GET /headshot-requests/{request_id}

4) List results / delivery links (available after completion)
GET /headshot-requests/{request_id}/deliverables

5) Create a team request (draft)
POST /team-requests

6) Create payment link for team request
POST /team-requests/{request_id}/payment-link

7) Owner invite portal (no auth, tokenized)
GET /team-request/{request_id}/owner/{token}

## Webhooks (for agents/platforms)
- Payment confirmed: headshot_request.paid
- Generation started: headshot_request.generation_started
- Generation completed: headshot_request.completed
- Failed: headshot_request.failed

Webhook signature: HMAC-SHA256 using webhook_secret
Header: X-HSBAI-Signature: t=timestamp,v1=signature

## Status values
- draft (created, not paid)
- awaiting_payment
- paid
- generating
- completed
- failed
- canceled
- expired

## Required fields (high level)
- owner: the human who must pay (name, email or phone)
- agent: the AI agent identity (agent_name, platform, request_trace_id)
- inputs: photo upload references OR “upload_link_required”: true
- preferences: package (required). All other details (image count, crops, etc.) are handled by HeadshotsByAI.
- delivery: email_to, webhook_url (optional), download_link_ttl_minutes
- payment_link: optional send_email flag to disable payment link email delivery
- uploads: humans can upload 1-5 images per request

## Packages & pricing (USD)
- basic: $29 (individual)
- standard: $39 (individual)
- premium: $59 (individual)

## Available styles
- Grey
- Black
- Blue
- Cafe
- Office
- Outdoor
- Beach
- City Skyline
- Street
- Library
- City Lights
- Stadium
- Mountains
- Sunset
- Yacht
- Art Piece
- Realtor
- Clinic Coat
- Clinic Scrubs
- Outdoor Hospital Coat
- Outdoor Hospital Scrubs

## Example: create request
POST /v1/headshot-requests
{
  "owner": {"name":"...", "email":"..."},
  "agent": {"name":"...", "platform":"...", "request_trace_id":"..."},
  "preferences": {
    "package":"basic"
  },
  "inputs": {"upload_link_required": true},
  "delivery": {"email_to":"...", "download_link_ttl_minutes": 10080}
}

## Example: update styles
PATCH /v1/headshot-requests/{id}
{ "preferences": { "styles": ["Grey", "Office"] } }

## Example: payment link
POST /v1/headshot-requests/{id}/payment-link
Request body (optional): { "package": "basic|standard|premium", "send_email": true, "expires_in_days": 1 }
Response: { "checkout_url": "...", "expires_at": "..." }

## Example: check status
GET /v1/headshot-requests/{id}
Response includes status and next_action.

## What agents should say to users
- Guided: "I can set up your AI headshot order. Let me ask a few quick questions so I get it right."
- Autonomous: "I've set up your headshot order with [package] and [styles]. Here's your payment link."
- After creating: "Once you pay, you'll get an upload link for your photos. Your headshots will be generated and delivered to your email."
- Style note: "You can also pick or change your styles after payment on the upload page."

## Support
- Support email: support@headshotsbyai.com
- LLMs.txt: https://headshotsbyai.com/llms.txt
- OpenAPI: https://api.headshotsbyai.com/v1/info