---
title: "Embeddings (OpenAI-compatible)"
method: POST
path: "/api/v1/ai/embeddings"
tags: ["AI"]
---

# Embeddings (OpenAI-compatible)

`POST /api/v1/ai/embeddings`

## Request

- Base URL: `https://core.blink.new`
- URL: `https://core.blink.new/api/v1/ai/embeddings`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

OpenAI-compatible embeddings endpoint. Use your Blink workspace API key in place of an OpenAI key.
`input` accepts a string or an array of strings. The default model is `openai/text-embedding-3-small`
(1536 dims). Bare OpenAI model names (e.g. `text-embedding-3-small`) are accepted and mapped to the
gateway provider automatically.

## Request body

- object
  - `model` string
  - `input` union, required
    - string
    - string[]
  - `encoding_format` 'float' | 'base64': `base64` returns each embedding as a little-endian float32 base64 string (OpenAI SDK default).

## Response `200`

OpenAI-format embeddings list.

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

## Other responses

- `400`: Invalid request: missing or malformed `input`, or, when zero data retention is enabled for AI requests, a model that cannot run under it (error `code` `MODEL_NOT_ZDR_ELIGIBLE`).
- `401`: Authentication required or invalid API key
- `402`: Insufficient credits.
- `500`: Internal server error

---

[API](https://skmtc.dev/blink/apis/blink-apis.md) - [All operations](https://skmtc.dev/blink/apis/blink-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/blink/apis/blink-apis/revisions/4c59c706078e?raw)