---
title: "Create embedding"
method: POST
path: "/v1/embeddings"
---

# Create embedding

`POST /v1/embeddings`

Create vector embeddings for text input using embedding models.

## Request body

- EmbeddingRequest
  - `input` union, required — Input text to embed, encoded as a string, array of strings, array of tokens, or array of token arrays
    - string — A single text string to embed
    - string[] — An array of text strings to embed
    - integer[] — An array of token integers to embed
    - array[] — An array of token arrays to embed
      - integer[]
  - `model` string, required — The model name to use for embedding generation
  - `dimensions` integer — The number of dimensions the resulting output embeddings should have
  - `encoding_format` 'float' | 'base64' — The format to return the embeddings in. Can be either float or base64.
  - `user` string — A unique identifier representing your end-user.

## Response `200`

Embedding response

- EmbeddingResponse
  - `data` EmbeddingData[], required — The list of embeddings generated by the model
    - `embedding` union, required — The embedding vector, the format of which is determined by the encoding_format parameter
      - number[] — The embedding vector as an array of floats
      - string — The embedding vector as a base64-encoded string
    - `index` integer, required — The index of the embedding in the list
    - `object` string, required — The object type, which is always 'embedding'
  - `model` string, required — The name of the model used to generate the embedding
  - `object` string, required — The object type, which is always 'list'
  - `usage` EmbeddingUsage, required
    - `prompt_tokens` integer, required — The number of tokens used by the prompt
    - `total_tokens` integer, required — The total number of tokens used by the request

## Other responses

- `400` — Bad request - malformed payload or invalid parameters.
- `401` — Unauthorized - missing or empty Authorization header.
- `402` — Payment required - organization balance exhausted.
- `403` — Forbidden - invalid token or model not in access list.
- `404` — Not found - provider/model not supported.
- `429` — Rate limit exceeded. Retry after the Retry-After header value.
- `500` — Internal server error.
- `502` — Bad gateway - upstream provider returned an invalid response.

---

[API](https://skmtc.dev/requesty/apis/requesty-api.md) · [All operations](https://skmtc.dev/requesty/apis/requesty-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/requesty/requesty-api/revisions/63bc7d99ccde/schema)