Skip to main content
POST
/
v1
/
ai
/
skin-enhancer
/
flexible
Skin enhancer using AI (Flexible)
curl --request POST \
  --url https://api.freepik.com/v1/ai/skin-enhancer/flexible \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '
{
  "image": "https://example.com/portrait.jpg",
  "sharpen": 0,
  "smart_grain": 2,
  "optimized_for": "enhance_skin",
  "webhook_url": "https://www.example.com/webhook"
}
'
{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Body

application/json
​
image
string
required

Input image. Supports Base64 encoding or HTTPS URL (must be publicly accessible).

Example:

"https://example.com/portrait.jpg"

​
sharpen
integer
default:0

Sharpening intensity

Required range: 0 <= x <= 100
Example:

0

​
smart_grain
integer
default:2

Smart grain intensity

Required range: 0 <= x <= 100
Example:

2

​
optimized_for
enum<string>
default:enhance_skin

Optimization target for flexible skin enhancer

Available options:
enhance_skin,
improve_lighting,
enhance_everything,
transform_to_real,
no_make_up
​
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

Example:

"https://www.example.com/webhook"

Response

OK - The task exists and the status is returned

​
data
object
required
Example:
{
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED",
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ]
}