Skip to content

Colorize

Request

Description

Add vivid colors to B&W photos or convert color to B&W. Example: style: "color_contemporary"

Input ImageOutput Image
Headers
api_tokenstringrequired
Bodyapplication/json
imagestringrequired

The source image to be handled by the API.
Supported input types:

  • Base64-encoded string - URL pointing to an image file that is publicly accessible and available at the time of processing.
    Accepted formats: JPEG, JPG, PNG, WEBP.
colorstringrequired

The restoration/color style ID.

Enum:"color_contemporary""color_vivid""black_and_white""sepia_vintage"
webhook_urlstring, (uri)

Optional URL for receiving the result via webhook when the async job completes. See Webhooks.

POST
/colorize
curl -i -X POST \
  https://engine.prod.bria-api.com/v2/image/edit/colorize \
  -H 'Content-Type: application/json' \
  -H 'api_token: string' \
  -d '{
    "image": "string",
    "color": "color_contemporary",
    "webhook_url": "http://example.com"
  }'

Responses

Successful operation (Synchronous Success)

Bodyapplication/json
resultobjectrequired
request_idstringrequired
warningstring

Returned only when ip_signal = true and the instruction field included IP content.

Response
{ "result": { "image_url": "string", "seed": 0, "structured_instruction": "string" }, "request_id": "string", "warning": "string" }