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

# POST /v1/embeddings

`POST /v1/embeddings`

OpenAI-compatible embeddings proxy. A 200 response contains one embedding per input; partial or truncated internal encode success is treated as a 500 INTERNAL_ERROR instead of returning a partial 200. Every error path returns the OpenAI `{error:{message,type,param,code}}` envelope (inner SIE-native encode failures are translated), so an `openai`-client error handler works unchanged.

## Headers

- `X-SIE-MACHINE-PROFILE` string, nullable
- `X-SIE-Pool` string, nullable
- `X-SIE-SDK-Version` string, nullable

## Request body

- OpenAIEmbeddingRequest — OpenAI-compatible ``POST /v1/embeddings`` request (subset supported on gateway).
  - `dimensions` integer, nullable — Accepted but ignored; the gateway returns the model's native dimension.
  - `encoding_format` 'float' | 'base64'
  - `input` union, required
    - string
    - string[]
  - `model` string, required
  - `user` string, nullable — Accepted but ignored; kept for OpenAI SDK compatibility.

## Response `200`

OpenAI-compatible embeddings response

- OpenAIEmbeddingsListResponse
  - `data` OpenAIEmbeddingDataEntry[], required
    - `embedding` union, required
      - number[]
      - string
    - `index` integer, required
    - `object` string, required
  - `model` string, required
  - `object` string, required
  - `usage` OpenAIEmbeddingUsage, required
    - `prompt_tokens` integer, required
    - `total_tokens` integer, required

## Other responses

- `400` — Invalid request
- `401` — Missing or invalid bearer token
- `404` — Model not found
- `409` — Bundle override conflicts with model routing
- `413` — Request body too large
- `500` — All batch items failed or gateway internal error; gateway auth enabled but no tokens configured
- `502` — MODEL_LOAD_FAILED
- `503` — Provisioning in progress, queue unavailable, GPU not configured, model loading, or capacity exhausted
- `504` — Result channel closed

---

[API](https://skmtc.net/superlinked/apis/sie-gateway.md) · [All operations](https://skmtc.net/superlinked/apis/sie-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/superlinked/sie-gateway/versions/06a326e2c3e9/schema)