GET

/v1/schemas/cohere/embeddings/v2%2Fembed

kind inputactivity embeddingshash 1ec6dada…extracted Sep 30, 2026version currentsource upstream spec ↗

Request body

10 properties · 2 required · 8 $defs
propertytypedescriptionconstraints
model*stringID of one of the available [Embedding models](https://docs.cohere.com/docs/cohere-embed).
input_type*enumSpecifies the type of input passed to the model. Required for embedding models v3 and higher.search_document | search_query | classification | clustering | image
textsstring[]An array of strings for the model to embed. Maximum number of texts per call is `96`.items ≥ 1 · items ≤ 96
imagesstring[]An array of image data URIs for the model to embed.items ≥ 1
inputsEmbedInput[]An array of inputs for the model to embed. Maximum number of inputs per call is `96`. An input can contain a mix of text and image components.
max_tokensintegerThe maximum number of tokens to embed per input. If the input text is longer than this, it will be truncated according to the `truncate` parameter.
output_dimensionintegerThe number of dimensions of the output embedding. This is only available for `embed-v4` and newer models. For supported dimensions, please refer to the [Embed models](https://docs.cohere.com/docs/cohere-embed) page.
embedding_typesEmbeddingType[]Specifies the types of embeddings you want to get back. Can be one or more of the following types.default: ["float"]
truncateenumOne of `NONE|START|END` to specify how the API will handle inputs longer than the maximum token length.NONE | START | END · default: "END"
priorityintegerControls how early the request is handled. Lower numbers indicate higher priority (default: 0, the highest). When the system is under load, higher-priority requests are processed first and are the least likely to be dropped.0 ≤ n ≤ 999 · default: 0

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"cohere","endpointId":"v2/embed","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}