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

# Create embedding

`POST /v1/embeddings`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v1/embeddings`
- Auth: HTTP bearer

Generate vector embeddings for one or more text inputs. Returns numerical arrays representing semantic meaning, useful for search, classification, and retrieval.

## Request body

- EmbeddingsRequest
  - `model` union, required: The name of the embedding model to use.<br> <br> [See all of Together AI's embedding models](https://docs.together.ai/docs/serverless-models#embedding-models)
    - 'WhereIsAI/UAE-Large-V1' | 'BAAI/bge-large-en-v1.5' | 'BAAI/bge-base-en-v1.5' | 'togethercomputer/m2-bert-80M-8k-retrieval'
    - string
  - `input` union, required
    - string: A string providing the text for the model to embed.
    - string[]

## Response `200`

200

- EmbeddingsResponse
  - `object` 'list', required: The object type, which is always `list`.
  - `model` string, required
  - `data` object[], required
    - `object` 'embedding', required: The object type, which is always `embedding`.
    - `embedding` number[], required
    - `index` integer, required

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `404`: NotFound
- `429`: RateLimit
- `503`: Overloaded
- `504`: Timeout

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v1/embeddings/post.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)