How do I call the Facial Feature Positioning API endpoint?

Send an HTTP request to https://api.acedata.cloud/face/analyze with a Bearer token in the Authorization header. See the documentation for request parameters and response format.

What authentication does Face Transformation require?

All Ace Data Cloud APIs use Bearer token authentication. Get your API key from the platform dashboard at https://platform.acedata.cloud and include it as: Authorization: Bearer YOUR_TOKEN

How much does Face Transformation cost?

Face Transformation uses pay-as-you-go pricing with no monthly fees. Each API call costs credits based on the model and parameters used. Visit the service page for detailed pricing.

Ace Data Cloud

Facial Feature Positioning API

POSThttps://api.acedata.cloud/face/analyze

This API can be used for facial landmark detection on the requested image, calculating 90 points that make up the facial contour, including eyebrows (8 points on each side), eyes (8 points on each side), nose (13 points), mouth (22 points), face shape contour (21 points), and pupils (2 points).

Request Headers

acceptstring

Specify the response format returned by the server.

Please select

authorizationstring

Bearer token

Request Body

image_urlstringRequired parameter

URL link of the image to be processed.

modenumber

Detection mode. `0` indicates to detect all faces appearing in the image, while `1` indicates to detect only the largest face. The default value is `0`.

face_model_versionstring

The version number of the algorithm model used for the facial recognition service. Different versions correspond to different facial recognition algorithms, and the new version performs better overall than the old version. It is recommended to use version `3.0`.

need_rotate_detectionnumber

Whether to enable image rotation recognition. `0` means off, `1` means on. The default value is `0`.

Response

OK, request successful.

Response Body

image_widthnumber

Width of the image (pixels).

image_heightnumber

Height of the image (pixels).

face_shape_setstring

Detailed information on facial landmark positioning (key points of the face), including coordinate data for key points such as eyebrows, eyes, nose, mouth, facial contours, and pupils.

face_model_versionstring

The version number of the algorithm model used for facial recognition this time.

Example

{
  "image_width": 904,
  "image_height": 602,
  "face_shape_set": [
    {
      "nose": [
        {
          "x": 561,
          "y": 312
        },
        {
          "x": 559,
          "y": 250
        },
        {
          "x": 551,
          "y": 267
        },
        {
          "x": 544,
          "y": 283
        },
        {
          "x": 536,
          "y": 300
        },
        {
          "x": 527,
          "y": 317
        },
        {
          "x": 544,
          "y": 326
        },
        {
          "x": 560,
          "y": 329
        },
        {
          "x": 574,
          "y": 326
        },
        {
          "x": 589,
          "y": 317
        },
        {
          "x": 582,
          "y": 300
        },
        {
          "x": 574,
          "y": 284
        },
        {
          "x": 566,
          "y": 267
        }
      ],
      "mouth": [
        {
          "x": 513,
          "y": 363
        },
        {
          "x": 526,
          "y": 375
        },
        {
          "x": 541,
          "y": 383
        },
        {
          "x": 558,
          "y": 386
        },
        {
          "x": 574,
          "y": 383
        },
        {
          "x": 589,
          "y": 375
        },
        {
          "x": 600,
          "y": 363
        },
        {
          "x": 586,
          "y": 356
        },
        {
          "x": 572,
          "y": 350
        },
        {
          "x": 559,
          "y": 354
        },
        {
          "x": 545,
          "y": 350
        },
        {
          "x": 529,
          "y": 356
        },
        {
          "x": 528,
          "y": 364
        },
        {
          "x": 543,
          "y": 366
        },
        {
          "x": 558,
          "y": 367
        },
        {
          "x": 572,
          "y": 365
        },
        {
          "x": 586,
          "y": 364
        },
        {
          "x": 586,
          "y": 363
        },
        {
          "x": 572,
          "y": 364
        },
        {
          "x": 558,
          "y": 365
        },
        {
          "x": 543,
          "y": 364
        },
        {
          "x": 528,
          "y": 363
        }
      ],
      "left_eye": [
        {
          "x": 470,
          "y": 242
        },
        {
          "x": 481,
          "y": 247
        },
        {
          "x": 492,
          "y": 249
        },
        {
          "x": 504,
          "y": 248
        },
        {
          "x": 516,
          "y": 245
        },
        {
          "x": 506,
          "y": 237
        },
        {
          "x": 494,
          "y": 233
        },
        {
          "x": 481,
          "y": 235
        }
      ],
      "right_eye": [
        {
          "x": 641,
          "y": 245
        },
        {
          "x": 630,
          "y": 250
        },
        {
          "x": 618,
          "y": 251
        },
        {
          "x": 606,
          "y": 251
        },
        {
          "x": 594,
          "y": 248
        },
        {
          "x": 604,
          "y": 238
        },
        {
          "x": 617,
          "y": 235
        },
        {
          "x": 630,
          "y": 236
        }
      ],
      "left_pupil": [
        {
          "x": 494,
          "y": 239
        }
      ],
      "right_pupil": [
        {
          "x": 618,
          "y": 242
        }
      ],
      "face_profile": [
        {
          "x": 432,
          "y": 240
        },
        {
          "x": 432,
          "y": 266
        },
        {
          "x": 434,
          "y": 291
        },
        {
          "x": 439,
          "y": 316
        },
        {
          "x": 445,
          "y": 341
        },
        {
          "x": 456,
          "y": 364
        },
        {
          "X": 470,
          "Y": 385
        },
        {
          "X": 488,
          "Y": 403
        },
        {
          "X": 508,
          "Y": 418
        },
        {
          "X": 531,
          "Y": 430
        },
        {
          "X": 556,
          "Y": 434
        },
        {
          "X": 580,
          "Y": 429
        },
        {
          "X": 602,
          "Y": 417
        },
        {
          "X": 621,
          "Y": 402
        },
        {
          "X": 638,
          "Y": 384
        },
        {
          "X": 652,
          "Y": 364
        },
        {
          "X": 662,
          "Y": 341
        },
        {
          "X": 669,
          "Y": 318
        },
        {
          "X": 673,
          "Y": 293
        },
        {
          "X": 676,
          "Y": 269
        },
        {
          "X": 676,
          "Y": 244
        }
      ],
      "left_eye_brow": [
        {
          "x": 447,
          "y": 217
        },
        {
          "x": 466,
          "y": 219
        },
        {
          "x": 485,
          "y": 221
        },
        {
          "x": 504,
          "y": 224
        },
        {
          "x": 523,
          "y": 226
        },
        {
          "x": 507,
          "y": 214
        },
        {
          "x": 486,
          "y": 209
        },
        {
          "x": 466,
          "y": 208
        }
      ],
      "right_eye_brow": [
        {
          "x": 662,
          "y": 223
        },
        {
          "x": 644,
          "y": 224
        },
        {
          "x": 626,
          "y": 225
        },
        {
          "x": 608,
          "y": 227
        },
        {
          "x": 590,
          "y": 227
        },
        {
          "x": 606,
          "y": 217
        },
        {
          "x": 626,
          "y": 213
        },
        {
          "x": 646,
          "y": 212
        }
      ]
    }
  ],
  "face_model_version": "3.0"
}

Allow Use General Balance

When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.

Shell

Python

JavaScript

Java

PHP

Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.