<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/keras-team/keras/tree/v3.15.1/keras/src/ops/image.py#L1205-L1273) |

Pad `images` with zeros to the specified `height` and `width`.

    tf.keras.ops.image.pad_images(
        images,
        top_padding=None,
        left_padding=None,
        bottom_padding=None,
        right_padding=None,
        target_height=None,
        target_width=None,
        data_format=None
    )

<br />

<br />

<br />

| ## Args ||
|---|---|
| `images` | Input image or batch of images. Must be 3D or 4D. |
| `top_padding` | Number of rows of zeros to add on top. |
| `left_padding` | Number of columns of zeros to add on the left. |
| `bottom_padding` | Number of rows of zeros to add at the bottom. |
| `right_padding` | Number of columns of zeros to add on the right. |
| `target_height` | Height of output images. |
| `target_width` | Width of output images. |
| `data_format` | A string specifying the data format of the input tensor. It can be either `"channels_last"` or `"channels_first"`. `"channels_last"` corresponds to inputs with shape `(batch, height, width, channels)`, while `"channels_first"` corresponds to inputs with shape `(batch, channels, height, width)`. If not specified, the value will default to [`keras.config.image_data_format`](https://www.tensorflow.org/api_docs/python/tf/keras/backend/image_data_format). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| Padded image or batch of images. ||

<br />

#### Example:

    images = np.random.random((15, 25, 3))
    padded_images = keras.ops.image.pad_images(
        images, 2, 3, target_height=20, target_width=30
    )
    padded_images.shape
    (20, 30, 3)

    batch_images = np.random.random((2, 15, 25, 3))
    padded_batch = keras.ops.image.pad_images(
        batch_images, 2, 3, target_height=20, target_width=30
    )
    padded_batch.shape
    (2, 20, 30, 3)