Portrait Photo — AI portrait photos from your selfies

Tools / Portrait Photo

Generate Portrait

Generate a portrait photo from one or more reference images. Specify a style or let it default to a clean, professional look.

Returns: Portrait image URL, downloadable asset, model used, reference count, seed, and request metadata

Parameters

reference_images *arrayOne or more URLs of photos of the person. More photos improve likeness.

stylestringDesired portrait style (e.g. "professional headshot", "LinkedIn photo", "cinematic editorial", "warm casual outdoor").

modelstringModel to use. Defaults to Nano Banana 2. Pass a model key or fal.ai endpoint ID to override.

aspect_ratiostringAspect ratio for the output. Defaults to 3:4 (portrait orientation).

output_formatstringOutput image format. Defaults to jpeg.

seednumberRandom seed for reproducible results.

extra_paramsobjectAdditional model-specific parameters passed directly to the inference API.

Example

Professional headshot from a single selfie

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "portrait-photo",
  "skill": "generate_portrait",
  "input": {
    "reference_images": [
      "https://example.com/my-selfie.jpg"
    ],
    "style": "professional corporate headshot, clean background, studio lighting"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"portrait-photo","skill":"generate_portrait","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

How many photos should I upload?

`generate_portrait` works with one reference image, but more reference photos usually improve likeness.

Can I ask for a specific look?

Yes. Pass a style prompt for a professional headshot, LinkedIn photo, editorial look, or anything else you want.

Will it keep my identity accurate?

The reference images are used to preserve likeness, so clear selfies work best when you want the result to read as you.

Can I change the model?

Yes. It defaults to Nano Banana 2, but the `model` param lets you override the aesthetic.