Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-2638658.5 KB
Avatar

Generate Photo Avatar

Generate AI photo avatar based on provided parameters

post/v2/photo_avatar/photo/generate

Request body

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

backgroundstring

Background description

appearancestring

Appearance description

image_urlstring

Reference image URL

Example request

{
  "age": "Adult",
  "avatar_style": "Professional",
  "gender": "Female",
  "model": "modern",
  "aspect_ratio": "portrait"
}

Response

Success

codeinteger 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
msgstring required

Response message

Example response

{
  "msg": "Success"
}