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

# Generate Photo Avatar

`POST /v2/photo_avatar/photo/generate`

Generate AI photo avatar based on provided parameters

## Request body

- object
  - `age` 'Teenager' | 'Young adult' | 'Adult' | 'Elderly', required — Avatar age group
  - `avatar_style` 'Professional' | 'Social', required — Avatar style category
  - `gender` 'Female' | 'Male', required — Avatar gender
  - `model` 'classic' | 'modern', required — Photo generation model style
  - `aspect_ratio` 'portrait' | 'landscape' | 'square', required — Photo aspect ratio
  - `ethnicity` 'European' | 'African' | 'South Asian' | 'East Asian' | 'Middle Eastern' | 'South American' | 'North American' — Avatar ethnicity
  - `background` string — Background description
  - `appearance` string — Appearance description
  - `image_url` string — Reference image URL

## Response `200`

Success

- object
  - `code` integer, required — Business status code: * 0 - Success * 10104 - Record not found * 10105 - Invalid API key * 18020 - Insufficient credit * 18025 - No permission to call APIs * 40000 - Parameter error * 50000 - System error
  - `msg` string, required — Response message
  - `data` object
    - `photo_id` string

---

[API](https://skmtc.net/jogg/apis/joggai-openapi-v2.md) · [All operations](https://skmtc.net/jogg/apis/joggai-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jogg/joggai-openapi-v2/revisions/ec8807ce9c12/schema)