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

# Create embeddings

`POST /v1/embeddings`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/embeddings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon/docs/v1/embeddings/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates an embedding vector for the provided input text. OpenAI-compatible endpoint.

## Request body

- EmbeddingRequest
  - `model` string, required: Model identifier to use for embedding
  - `input` string, required: Text to embed
  - `user` string: Optional user identifier

## Response `200`

Embedding created successfully

- EmbeddingResponse
  - `object` 'list'
  - `data` object[]
    - `object` 'embedding'
    - `index` integer
    - `embedding` number[]: Embedding vector
  - `model` string
  - `usage` object
    - `prompt_tokens` integer
    - `total_tokens` integer

## Other responses

- `400`: Invalid request
- `503`: Model not ready

## Changes

- **2026-04-15** `d2b50f383fdf`: 1 info
  - endpoint added
- **2026-04-03** `d051d35964ca`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon/changes/v1/embeddings/post.md)

---

[API](https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon.md) - [All operations](https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon/llms.txt) - [OpenAPI document](https://skmtc.dev/tenstorrent/apis/tt-media-server-api-c-drogon/revisions/f1176db3fd15?raw)