---
title: "POST /retrieval:vectorizeImage"
method: POST
path: "/retrieval:vectorizeImage"
---

# POST /retrieval:vectorizeImage

`POST /retrieval:vectorizeImage`

Return vector from an image.

## Query parameters

- `model-version` string, required
- `api-version` string, required

## Request body

- ImageUrl — A JSON document with a URL pointing to the publicly accessible image to be analyzed.
  - `url` string, uri, required — Publicly reachable URL of an image.

## Response `200`

Success

- SingleVectorResult — Results of image vectorization.
  - `vector` number[] — Vector of the image.
  - `modelVersion` string — Model version.

## Other responses

- `default` — Error

## Changes

- **2026-07-13** (2023-02-01-preview) `047f04ae4b61` — 1 info
  - endpoint added
- **2026-07-13** (2023-02-01-preview) `4021295051f4` — 1 breaking
  - api path removed without deprecation
- **2023-03-07** (2023-02-01-preview) `cd3b1515d86b` — 3 info
  - api operation id `Vectorize_Image` removed and replaced with `ImageRetrieval_VectorizeImage`
  - api tag `ImageRetrievalApi` added
  - the `query` request parameter `model-version` became optional

[Change history](https://skmtc.dev/azure/apis/cognitiveservices-unifiedvision/changes/retrieval:vectorizeImage/post.md)

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-unifiedvision.md) · [All operations](https://skmtc.dev/azure/apis/cognitiveservices-unifiedvision/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/cognitiveservices-unifiedvision/revisions/047f04ae4b61/schema)