[view as .md]

Embeddings

Create vector embeddings. OpenAI-compatible request and response shape.

POST /v1/embeddings

Request

{
  "model": "text-embedding-3-small",
  "input": ["Hello world", "Another string"]
}

Supports:

  • Single string or array of strings
  • Routing config slugs (@embeddings) just like chat completions
  • OpenAI, Google, Cohere, and Voyage embedding models through their respective providers

Response

{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.012, -0.034, ...] },
    { "object": "embedding", "index": 1, "embedding": [0.056, 0.089, ...] }
  ],
  "model": "text-embedding-3-small",
  "usage": { "prompt_tokens": 10, "total_tokens": 10 }
}

Dimensions

Pass dimensions: N to request a specific vector dimensionality (where the provider supports it, e.g. text-embedding-3-small and text-embedding-3-large).