API Reference

Merge Face ​

POST https://api.newportai.com/api/async/merge_face

Face Merging API facilitates the seamless merging of two faces, generating a composite image harmoniously blends features from both. The resulting image integrates characteristics from each input, creating a unified representation.

  • Use Face Merging API to get taskId with POST method.
  • Use Polling API to get Face Merging result with POST mehtod.

Request Header Parameters ​

  • Content-TypestringRequired
    Enum
    application/json
  • AuthorizationstringRequired
    Bearer authentication format, for example: Bearer

Request Body Parameters ​

  • urlstringRequired
    url of the original image, with a maximum resolution of 16 megawpixels and a max file size of 10MB.
  • faceImgUrlstringRequired
    url of target face image, with a maximum resolution of 16 megawpixels and a max file size of 10MB.

Response ​

  • codeinteger
    0 success, or error code.
  • messagestring
    "success", or error msg.
  • dataobject
    taskIdstring
    Use the taskId to request the Polling API to retrieve the generated outputs.

Example ​

Request:

zsh
curl -X POST 'https://api.newportai.com/api/async/merge_face' \
-H "Authorization: Bearer {{key}}" \
-H 'Content-Type: application/json' \
--data '{
  "url": "https://newportai-api-market.s3.amazonaws.com/demo_image/demo_image.jpg",
  "faceImgUrl": "https://newportai-api-market.s3.amazonaws.com/demo_painting/faceimagedemo.jpg"
}'

Response:

json
{
  "code": 0,
  "message": "success", 
  "data": {
    "taskId": "b08337dc08d7428daa64b3d5e61b8350"
  }
}

Next Step: ​

Use Polling API to get the result.

Demo ​

before
after