---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/portrait-photo
---
# Portrait Photo

Upload one or more photos of yourself and get back a polished portrait photo. Choose a style — professional headshot, LinkedIn photo, creative editorial, or anything you describe. Multiple reference photos improve likeness accuracy.

- **Version:** 0.01
- **Categories:** media, ai

## Skills (1)

### Generate Portrait (`generate_portrait`)

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

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `reference_images` | array | Yes | One or more URLs of photos of the person. More photos improve likeness. |
| `style` | string | No | Desired portrait style (e.g. "professional headshot", "LinkedIn photo", "cinematic editorial", "warm casual outdoor"). |
| `model` | string | No | Model to use. Defaults to Nano Banana 2. Pass a model key or fal.ai endpoint ID to override. |
| `aspect_ratio` | string | No | Aspect ratio for the output. Defaults to 3:4 (portrait orientation). (1:1, 3:4, 4:3, 9:16, 16:9, 3:2, 2:3) |
| `output_format` | string | No | Output image format. Defaults to jpeg. (jpeg, png, webp) |
| `seed` | number | No | Random seed for reproducible results. |
| `extra_params` | object | No | Additional model-specific parameters passed directly to the inference API. |

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

**Examples:**

*Professional headshot from a single selfie:*

```json
{
  "reference_images": [
    "https://example.com/my-selfie.jpg"
  ],
  "style": "professional corporate headshot, clean background, studio lighting"
}
```

*Creative portrait from multiple reference photos:*

```json
{
  "reference_images": [
    "https://example.com/photo1.jpg",
    "https://example.com/photo2.jpg"
  ],
  "style": "cinematic editorial portrait, dramatic lighting, shallow depth of field"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call portrait-photo generate_portrait --reference_images https://example.com/my-selfie.jpg --style professional corporate headshot, clean background, studio lighting

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -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
```

## 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.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs