Skip to main content
POST
/
v2
/
photo_avatar
/
photo
/
generate
Generate Photo Avatar
curl --request POST \
  --url https://api.jogg.ai/v2/photo_avatar/photo/generate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "age": "Adult",
  "avatar_style": "Professional",
  "gender": "Female",
  "model": "modern",
  "aspect_ratio": "portrait",
  "background": "<string>",
  "appearance": "<string>",
  "image_url": "<string>"
}
'
{
  "code": 0,
  "msg": "Success",
  "data": {
    "photo_id": "<string>"
  }
}
Generate a custom AI avatar from a photo. Upload a portrait photo to create a talking avatar.

​
Example Usage

curl -X POST 'https://api.jogg.ai/v2/photo_avatar/photo/generate' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "photo_url": "https://example.com/portrait.jpg",
    "name": "John Doe Avatar"
  }'

Create Photo Avatar Guide

Complete photo avatar workflow

Authorizations

​
x-api-key
string
header
required

API key for authentication. Obtain your key from the JoggAI dashboard.

Body

application/json
​
age
enum<string>
required

Avatar age group

Available options:
Teenager,
Young adult,
Adult,
Elderly
Example:

"Adult"

​
avatar_style
enum<string>
required

Avatar style category

Available options:
Professional,
Social
Example:

"Professional"

​
gender
enum<string>
required

Avatar gender

Available options:
Female,
Male
Example:

"Female"

​
model
enum<string>
required

Photo generation model style

Available options:
classic,
modern
Example:

"modern"

​
aspect_ratio
enum<string>
required

Photo aspect ratio

Available options:
portrait,
landscape,
square
Example:

"portrait"

​
ethnicity
enum<string>

Avatar ethnicity

Available options:
European,
African,
South Asian,
East Asian,
Middle Eastern,
South American,
North American
​
background
string

Background description

​
appearance
string

Appearance description

​
image_url
string

Reference image URL

Response

200 - application/json

Success

​
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
Example:

0

​
msg
string
required

Response message

Example:

"Success"

​
data
object