---
title: "Generate photo avatar photos"
method: POST
path: "/v2/photo_avatar/photo/generate"
tags: ["Photo Avatars"]
---

# Generate photo avatar photos

`POST /v2/photo_avatar/photo/generate`

This endpoint will generate photos that can be used to create photo avatars, returns a generation id, which can be used in the check generation status endpoint to get status and final image/image keys

## Request body

- object
  - `name` string
  - `age` 'Young Adult' | 'Early Middle Age' | 'Late Middle Age' | 'Senior' | 'Unspecified'
  - `gender` 'Woman' | 'Man' | 'Unspecified'
  - `ethnicity` 'White' | 'Black' | 'Asian American' | 'East Asian' | 'South East Asian' | 'South Asian' | 'Middle Eastern' | 'Pacific' | 'Hispanic' | 'Unspecified'
  - `orientation` 'square' | 'horizontal' | 'vertical'
  - `pose` 'half_body' | 'close_up' | 'full_body'
  - `style` 'Realistic' | 'Pixar' | 'Cinematic' | 'Vintage' | 'Noir' | 'Cyberpunk' | 'Unspecified'
  - `appearance` string — Description/Prompt of the generated avatar photo, maximum 1000 characters

## Response `200`

200

- object
  - `error` unknown
  - `data` object
    - `generation_id` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/heygen/apis/heygen-api.md) · [All operations](https://skmtc.net/heygen/apis/heygen-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heygen/heygen-api/revisions/2f19176d6d56/schema)