Skip to main content
POST
Create embeddings (OpenAI-compatible)

Authorizations

Authorization
string
header
required

Gateway API key (imp-rt-...) from POST /v1/accounts or /v1/keys.

Body

application/json
model
string
required
Example:

"openai/text-embedding-3-small"

input
required

One string, or a batch of them. Pre-tokenized (integer array) input is not supported.

encoding_format
enum<string>
default:float

base64 returns each vector as base64-encoded little-endian float32 instead of a JSON number array.

Available options:
float,
base64
dimensions
integer

Shorten the output vector. Defaults to the model's native size (1536 for 3-small, 3072 for 3-large).

user
string

Stable per-user id forwarded to the provider for abuse monitoring.

Response

A list of embedding objects, in the same order as input.

object
string
Example:

"list"

model
string
Example:

"openai/text-embedding-3-small"

data
object[]
usage
object

Embeddings consume input tokens only, so both fields always match.