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

# Create embeddings

`POST /embeddings`

Generate vector embeddings for one or more inputs. OpenAI-compatible response shape. The gateway does not replay-cache this operation.

## Request body

- EmbeddingRequest
  - `model` string, required
  - `input` union, required
    - string
    - string[]
  - `encoding_format` 'float' | 'base64'

## Response `200`

Embedding response

- EmbeddingResponse
  - `object` string, required
  - `data` object[], required
    - `object` string
    - `index` integer
    - `embedding` number[]
  - `model` string, required
  - `usage` object, required
    - `prompt_tokens` integer
    - `total_tokens` integer

## Other responses

- `400` — Malformed request
- `401` — Missing or invalid API key
- `402` — Insufficient credits
- `403` — Key scope mismatch or plan limit exceeded
- `404` — Model or deployment not found
- `409` — Idempotency conflict
- `429` — Rate limit exceeded
- `500` — Unexpected gateway error
- `502` — Upstream serving backend transient failure
- `503` — Endpoint stopped, provisioning, or at capacity
- `504` — Gateway timeout

---

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