---
title: "Embeddings"
method: POST
path: "/v1/embeddings"
tags: ["embeddings"]
---

# Embeddings

`POST /v1/embeddings`

Embeddings

## Request body

- EmbeddingRequest
  - `model` string, required — ID of the model to use.
  - `metadata` object, nullable
  - `input` union, required — Text to embed.
    - string
    - string[]
  - `output_dimension` integer, nullable — The dimension of the output embeddings when feature available. If not provided, a default output dimension will be used.
  - `output_dtype` 'float' | 'int8' | 'uint8' | 'binary' | 'ubinary'
  - `encoding_format` 'float' | 'base64'

## Response `200`

Successful Response

- EmbeddingResponse
  - `id` string, required
  - `object` string, required
  - `model` string, required
  - `usage` UsageInfo, required
    - `prompt_tokens` integer, required
    - `completion_tokens` integer, required
    - `total_tokens` integer, required
    - `prompt_audio_seconds` integer, nullable
  - `data` EmbeddingResponseData[], required
    - `object` string
    - `embedding` number[]
    - `index` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)