---
title: "Embeddings"
method: POST
path: "/v1/embeddings"
---

# Embeddings

`POST /v1/embeddings`

Generate vector embeddings for one or more inputs using an OpenAI-compatible embeddings model.

## Request body

- object
  - `input` union, required — Input text to embed. A single string, an array of strings, an array of token IDs, or an array of token-ID arrays. Cannot exceed the model's max input tokens (8192 for OpenAI text-embedding-3 and ada-002).
    - string
    - string[]
    - integer[]
    - array[]
      - integer[]
  - `model` string, required — ID of the embedding model to use.
  - `encoding_format` 'float' | 'base64' — Format of the returned embeddings. `float` returns plain arrays, `base64` returns a packed base64 string.
  - `dimensions` integer — Number of dimensions for the output embeddings. Only supported by models that allow shortening output (e.g. `text-embedding-3-*`, `gemini-embedding-*`, `qwen3-embedding-8b`).
  - `user` string — Stable end-user identifier forwarded to OpenAI for abuse monitoring.

## Response `200`

Embeddings response.

- object — OpenAI-compatible embeddings response payload.
  - `object` 'list'
  - `data` object[]
    - `object` 'embedding', required
    - `embedding` union, required
      - number[]
      - string
    - `index` integer, required
  - `model` string
  - `usage` object
    - `prompt_tokens` integer, required
    - `total_tokens` integer, required

## Other responses

- `400` — Invalid request body or parameters.
- `401` — Unauthorized request.
- `402` — Payment required / Insufficient credits or retention.
- `403` — Forbidden upstream response.
- `404` — Not found upstream response.
- `410` — Archived or unavailable project.
- `429` — Rate limited upstream response.
- `500` — Internal server error.
- `502` — Failed to connect to the upstream provider.
- `503` — Service unavailable upstream response.
- `504` — Upstream provider timeout.

---

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