Run a Skin Analysis task.
AI tasks are asynchronous. Prefer webhook-based completion handling when the feature supports webhooks. Configure your webhook endpoint, verify webhook signatures, and use the received task_id to query the task result after a success or error notification. See the webhook integration guide for setup and verification details.
If webhooks are not supported for the feature, or if your integration cannot use webhooks, implement polling. After starting an AI task, keep polling the task status endpoint at the given polling_interval until the task status is either success or error.
Do not stop polling a running task for longer than the allowed polling window. If the task is not polled in time, the task may expire; a later status check can return InvalidTaskId even if processing finished, and the consumed units may still be charged.
Request body
Example request
{
"src_file_url": "https://example.com/selfie.jpg",
"dst_actions": [
"hd_wrinkle",
"hd_pore",
"hd_texture",
"hd_acne"
],
"miniserver_args": {
"color_dark_background_hd_pore": "3D3D3D",
"opacity_dark_background_hd_pore": 0.4,
"color_dark_background_hd_wrinkle": "3D3D3D",
"opacity_dark_background_hd_wrinkle": 0.4
},
"format": "zip"
}Response
Successful execution of Skin Analysis task
Example response
{
"status": 200,
"data": {
"task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"
}
}