Embeddings (OpenAI-compatible)

POST https://gateway.roadie.paroaria.ai/openai/v1/embeddings
Authorization: Bearer rd_sk_prod_…
Content-Type: application/json

The OpenAI Embeddings contract, for drop-in use with the OpenAI SDKs. Requests are translated to the unified contract and served exactly like the native POST /v1/embeddings.

Authentication

Authenticated with a secret key (rd_sk_…) or a client token (carrying the ai.embed scope). A publishable key is rejected 403.

Request body

Field	Type	Required	Notes
`model`	string	yes	Resolved the same way as chat completions.
`input`	string \| string[]	yes	One string or a batch of strings. Token-array input is not supported (`400` `unsupported_parameter`).
`dimensions`	integer	no	Requested output dimensionality, where the model supports it.
`encoding_format`	`'float'` \| `'base64'`	no	`float` (default) returns number arrays; `base64` returns little-endian float32 base64 strings.
`user`	string	no	Attributed as the end-user id.

Example

{
  "model": "text-embedding-3-small",
  "input": ["The quick brown fox.", "A second document."]
}

Response

200 OK — an OpenAI embeddings list:

{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0123, -0.0456, "…"] },
    { "object": "embedding", "index": 1, "embedding": [0.0789, -0.0021, "…"] }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": { "prompt_tokens": 12, "total_tokens": 12 }
}

With encoding_format: "base64", each embedding is a base64-encoded float32 string instead of a number array.

Errors

Errors use the OpenAI envelope; see the error mapping on the chat-completions page.

Introduction

Data plane

OpenAI-compatible

Control plane

Errors

Embeddings (OpenAI-compatible)

Authentication

Request body

Example

Response

Errors

​Authentication

​Request body

​Example

​Response

​Errors

Authentication

Request body

Example

Response

Errors