<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/keras-team/keras/tree/v2.15.0/keras/preprocessing/image.py#L2303-L2366) |

Performs a random spatial zoom of a Numpy image tensor.

    tf.keras.preprocessing.image.random_zoom(
        x,
        zoom_range,
        row_axis=1,
        col_axis=2,
        channel_axis=0,
        fill_mode='nearest',
        cval=0.0,
        interpolation_order=1
    )

> [!WARNING]
> **Deprecated:** [`tf.keras.preprocessing.image.random_zoom`](https://www.tensorflow.org/versions/r2.15/api_docs/python/tf/keras/preprocessing/image/random_zoom) does not operate on tensors and is not recommended for new code. Prefer [`tf.keras.layers.RandomZoom`](https://www.tensorflow.org/versions/r2.15/api_docs/python/tf/keras/layers/RandomZoom) which provides equivalent functionality as a preprocessing layer. For more information, see the tutorial for [augmenting images](https://www.tensorflow.org/tutorials/images/data_augmentation), as well as the [preprocessing layer guide](https://www.tensorflow.org/guide/keras/preprocessing_layers).

<br />

<br />

<br />

| ## Args ||
|---|---|
| `x` | Input tensor. Must be 3D. |
| `zoom_range` | Tuple of floats; zoom range for width and height. |
| `row_axis` | Index of axis for rows in the input tensor. |
| `col_axis` | Index of axis for columns in the input tensor. |
| `channel_axis` | Index of axis for channels in the input tensor. |
| `fill_mode` | Points outside the boundaries of the input are filled according to the given mode (one of `{'constant', 'nearest', 'reflect', 'wrap'}`). |
| `cval` | Value used for points outside the boundaries of the input if `mode='constant'`. |
| `interpolation_order` | int, order of spline interpolation. see `ndimage.interpolation.affine_transform` |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| Zoomed Numpy image tensor. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `ValueError` | if `zoom_range` isn't a tuple. |

<br />