AI Face Editor

POST

ai-face-editor

curl --request POST \
  --url https://api.magichour.ai/v1/ai-face-editor \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Face Editor image",
  "assets": {
    "image_file_path": "api-assets/id/1234.png"
  },
  "style": {
    "enhance_face": false,
    "eyebrow_direction": 0,
    "eye_gaze_horizontal": 0,
    "eye_gaze_vertical": 0,
    "eye_open_ratio": 0,
    "lip_open_ratio": 0,
    "head_roll": 0,
    "mouth_grim": 0,
    "mouth_pout": 0,
    "mouth_purse": 0,
    "mouth_smile": 0,
    "mouth_position_horizontal": 0,
    "mouth_position_vertical": 0,
    "head_pitch": 0,
    "head_yaw": 0
  }
}'

{
  "id": "clx7uu86w0a5qp55yxz315r6r",
  "frame_cost": 1
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Body

assets

object

required

Provide the assets for face editor

style

object

required

Face editing parameters

style.enhance_face

boolean

required

Enhance face features

Example:

false

style.eyebrow_direction

number

required

Eyebrow direction (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.eye_gaze_horizontal

number

required

Horizontal eye gaze (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.eye_gaze_vertical

number

required

Vertical eye gaze (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.eye_open_ratio

number

required

Eye open ratio (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.lip_open_ratio

number

required

Lip open ratio (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.head_roll

number

required

Head roll (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.mouth_grim

number

required

Mouth grim (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.mouth_pout

number

required

Mouth pout (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.mouth_purse

number

required

Mouth purse (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.mouth_smile

number

required

Mouth smile (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.mouth_position_horizontal

number

required

Horizontal mouth position (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.mouth_position_vertical

number

required

Vertical mouth position (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.head_pitch

number

required

Head pitch (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

style.head_yaw

number

required

Head yaw (-100 to 100), in increments of 5

Required range: -100 <= x <= 100Must be a multiple of 5

Example:

0

name

string

default:Face Editor - dateTime

The name of image

Example:

"Face Editor image"

Response

200

application/json

Success

string

required

Unique ID of the image. This value can be used in the get image project API to fetch additional details such as status

Example:

"clx7uu86w0a5qp55yxz315r6r"

frame_cost

integer

required

The frame cost of the image generation

Example:

1

Was this page helpful?

AI Clothes Changer AI GIFs

curl --request POST \
  --url https://api.magichour.ai/v1/ai-face-editor \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Face Editor image",
  "assets": {
    "image_file_path": "api-assets/id/1234.png"
  },
  "style": {
    "enhance_face": false,
    "eyebrow_direction": 0,
    "eye_gaze_horizontal": 0,
    "eye_gaze_vertical": 0,
    "eye_open_ratio": 0,
    "lip_open_ratio": 0,
    "head_roll": 0,
    "mouth_grim": 0,
    "mouth_pout": 0,
    "mouth_purse": 0,
    "mouth_smile": 0,
    "mouth_position_horizontal": 0,
    "mouth_position_vertical": 0,
    "head_pitch": 0,
    "head_yaw": 0
  }
}'

{
  "id": "clx7uu86w0a5qp55yxz315r6r",
  "frame_cost": 1
}

Files

Video Projects

Image Projects

Authorizations

Body

Response