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
Security
api_token
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
from bria_client import BriaSyncClient

client = BriaSyncClient()  # reads BRIA_API_TOKEN

job = client.submit(
    endpoint="image/edit/colorize",
    payload={
        "image": "<image>",
        "color": "color_contemporary",
    },
)
result = client.poll(job, interval=2, timeout=120)
print(result.result.image_url)

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" }