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

# POST /retrieval:vectorizeText

`POST /retrieval:vectorizeText`

Return vector from a text.

## Query parameters

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

## Request body

- VectorizeTextRequest — Model for VectorizeText request.
  - `text` string, required — Text for vectorization.

## 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_Text` removed and replaced with `ImageRetrieval_VectorizeText`
  - api tag `ImageRetrievalApi` added
  - the `query` request parameter `model-version` became optional

[Change history](https://skmtc.dev/azure/apis/cognitiveservices-unifiedvision/changes/retrieval:vectorizeText/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)