# Image Colorization

### Model Overview

**Image Colorization** automatically transforms black-and-white and faded images into natural, full-color results using context-aware color mapping.

It intelligently assigns realistic hues based on scene content, restoring life to historical photos and grayscale imagery while maintaining a natural, balanced appearance.

### Key Capabilities

* Converts black-and-white and faded images into realistic, full-color results.
* Automatically selects context-appropriate colors for natural-looking output.
* Ideal for restoring archival photos and enhancing historical imagery.

### Model Pricing

<table data-header-hidden data-full-width="false"><thead><tr><th width="119.84765625">Text</th><th width="60.390625" data-type="number">Number</th><th width="59.5390625" data-type="number"></th><th width="60.0859375" data-type="number"></th><th width="60.265625" data-type="number"></th><th width="59.94140625" data-type="number"></th><th width="59.5390625" data-type="number"></th><th width="60.34375" data-type="number"></th><th width="59.9296875" data-type="number"></th><th width="59.828125" data-type="number"></th><th width="59.5078125" data-type="number"></th></tr></thead><tbody><tr><td><code>Output MP</code></td><td>1</td><td>4</td><td>8</td><td>16</td><td>24</td><td>32</td><td>40</td><td>50</td><td>64</td><td>100</td></tr><tr><td><code>Credits</code></td><td>1</td><td>1</td><td>1</td><td>1</td><td>1</td><td>2</td><td>2</td><td>3</td><td>3</td><td>5</td></tr></tbody></table>

### Getting Started

**Endpoint**

* <https://api.topazlabs.com/image/v1/lighting/async>
  * `model` — `"Colorize"`

<details>

<summary><strong>Endpoint-Specific Parameters</strong></summary>

* `color_correction` — boolean
  * Adjust the vibrance.
* `exposure` — decimal between 0 and 2
  * Adjust the exposure.
* `highlight` — decimal between 0 and 2
  * Adjust prominence of highlights.
* `shadow` — decimal between 0 and 2
  * Adjust prominence of shadows.
* `temperature` — decimal between 0.01 and 1
  * Adjust overall warmth
* `opacity` — decimal between 0.01 and 1
  * Adjust strength of opacity.
* `saturation` — decimal between 0 and 1, default 0.2
  * Adjust saturation.

Any parameters that are not explicitly provided are configured to our default values. Extra parameters provided that are not supported are ignored.

</details>

**Model-Specific Parameters**

* No parameters

**Resolution Limits**

* `input` — 512 MP
* `output` — 512 MP

### Examples

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Click to view</td><td><a href="https://4007072434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJkSwaYgAsTQke14gpXAF%2Fuploads%2FyCDL9IqpeDeAPyDuwsib%2FImage_Colorization_slider.jpg?alt=media&#x26;token=ff0abb47-24e6-4e5f-80bd-f389d0ee2184">Image_Colorization_slider.jpg</a></td><td><a href="https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fpre%20color.jpeg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FColored.jpeg&#x26;src2label=After&#x26;zoom=1">https://compare.topazlabs.com/share/image?src1=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2Fpre%20color.jpeg&#x26;src1label=Before&#x26;src2=https%3A%2F%2Fdownloads.topazlabs.com%2Fweb-assets%2Fmodel-examples%2FColored.jpeg&#x26;src2label=After&#x26;zoom=1</a></td></tr></tbody></table>