# Professional Headshot - Core.Today AI API

> Turn any single photo into a polished professional business headshot, powered by FLUX.1 Kontext [pro]. Pick a background — white, black, gray, neutral, or office — and get a LinkedIn-ready portrait in one step.

- **Provider**: Black Forest Labs
- **Model ID**: flux-kontext-apps/professional-headshot
- **Category**: Image Generation
- **Credits**: 93 per image (fixed)
- **Speed**: Fast
- **Quality**: High

## Features
- One photo in, professional headshot out — no studio required
- FLUX.1 Kontext [pro] app tuned specifically for business portraits
- 5 background presets: white, black, neutral, gray, office
- Optional gender hint for more accurate rendering
- 14 aspect ratios including match_input_image

## Use Cases
- LinkedIn and resume profile photos
- Company website team pages with a consistent look
- Speaker and conference bio portraits
- Sales and real-estate agent profile photos
- Press kit and about-page headshots

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **input_image**: string - Image of the person to create a professional headshot for (jpeg, png, gif, or webp)

### Optional
- **seed**: integer - Random seed. Set for reproducible generation
- **gender**: string (default: none) - The gender of the person (optional hint)
  Options: none, male, female
- **background**: string (default: neutral) - The background of the headshot
  Options: white, black, neutral, gray, office
- **aspect_ratio**: string (default: match_input_image) - Aspect ratio of the generated image. 'match_input_image' keeps the input's ratio
  Options: match_input_image, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2
- **output_format**: string (default: png) - Output format for the generated image
  Options: jpg, png
- **safety_tolerance**: integer (default: 2) - Safety tolerance, 0 is most strict and 2 is most permissive. 2 is currently the maximum allowed.

## Examples

### Neutral Background Headshot
A square business headshot on a neutral background from one casual photo
```json
{
  "model": "flux-kontext-apps/professional-headshot",
  "input": {
    "input_image": "https://example.com/casual-photo.png",
    "gender": "female",
    "background": "neutral",
    "aspect_ratio": "1:1"
  }
}
```

### Office Background for Team Page
Use the office background and a fixed seed for a consistent team look
```json
{
  "model": "flux-kontext-apps/professional-headshot",
  "input": {
    "input_image": "https://example.com/selfie.jpg",
    "background": "office",
    "aspect_ratio": "4:5",
    "seed": 42
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- A clear, front-facing photo with the face well lit gives the most faithful headshot
- Use 'neutral' or 'gray' backgrounds for LinkedIn; 'office' adds a corporate environment feel
- Processing a whole team? Keep background and aspect_ratio identical across runs for a uniform look
- aspect_ratio defaults to match_input_image — set '1:1' or '4:5' explicitly for profile crops
- Only use photos of real people with their consent

## Documentation
https://replicate.com/flux-kontext-apps/professional-headshot