Colorize

POSThttps://api.newportai.com/api/async/colorize

The Colorize API enables developers to generate colorized versions of black-and-white photos. It is specifically designed to enhance historical photography and bring monochrome images to life with realistic, AI-driven color reproduction.

Submit a POST request to the Colorize API to obtain a taskId.
Submit a POST request to the Polling API to retrieve the colorized result.
Configure a Callback URL to receive results automatically on completion.

Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

Request Body

url string Required

The URL of the source image. Constraints: maximum resolution of 16 megapixels and a maximum file size of 10MB. Note: A visible face is required within the image for processing.

Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object

taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the generated output.

Errors

10192Illegal param

Polling

Use the Polling API to retrieve the processing results.

Callback

Alternatively, you can enable Callback to receive task results automatically upon completion.

0Task Completed

1234567891011121314151617{
  "code": 0,
  "message": "success",
  "data": {
    "task": {
      "taskId": "b08337dc08d7428daa64b3d5e61b8350",
      "status": 3,
      "taskType": "colorize"
    },
    "images": [
      {
        "imageType": "jpg",
        "imageUrl": "https://dreamface-resource-cv.oss-us-east-1.aliyuncs.com/aigc-dreamface-colorize/2025-04-17/colorized-image.jpg"
      }
    ]
  }
}

Request

cURL

123456curl -X POST 'https://api.newportai.com/api/async/colorize' \
  -H "Authorization: Bearer {{key}}" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/INj5UrnnrKIzCR1uYBWv0.png"
}'

0Successful

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