---
title: "Generate embeddings from text"
method: POST
path: "/v1/embeddings"
tags: ["LLM API"]
---

# Generate embeddings from text

`POST /v1/embeddings`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/embeddings`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Generates embeddings from caller-supplied text. Runtime-backed utility models use deterministic lexical hash embeddings, while configured provider-backed embedding models are routed through the provider service.

## Request body

- EmbeddingsRequest
  - `model` string: Embedding model identifier from GET /v1/models.
  - `input` union, required: One UTF-8 string or a list of UTF-8 strings to embed.
    - string
    - string[]
  - `dimensions` integer: Output embedding dimensionality for the deterministic lexical hash encoder.

## Response `200`

Successful Response

- EmbeddingsResponse
  - `object` 'list'
  - `model` string, required
  - `dimensions` integer, required
  - `provider_backend` string, nullable: Concrete provider backend that served this embeddings request when routed.
  - `provider_model_id` string, nullable: Concrete configured provider model that served this embeddings request when routed.
  - `provider_attempts` ProviderAttemptResponse[]: Ordered provider attempts made while serving this embeddings request.
    - `provider_backend` string, required
    - `provider_model_id` string, required
    - `outcome` 'selected' | 'failed', required
    - `error_code` string, nullable
  - `data` EmbeddingVectorResponse[], required
    - `object` 'embedding'
    - `index` integer, required
    - `embedding` number[], required
    - `token_count` integer, required
  - `usage` EmbeddingUsageResponse, required
    - `prompt_tokens` integer, required
    - `total_tokens` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/codna/apis/algenta-api.md) · [All operations](https://skmtc.dev/codna/apis/algenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/codna/apis/algenta-api/revisions/35d30f84a5df?raw)