Embeddings API

Generate embedding vectors for one or more texts. Drop-in compatible with OpenAI's POST https://api.openai.com/v1/embeddings — swap the base URL and key.

Request

Unrecognized fields are forwarded to the upstream — unsupported ones may be ignored or rejected depending on the provider.

Routing controls

AnyRouter routes each request through a fallback chain. Override the chain with these headers (no request body changes):

Caching

Embeddings are deterministic for a given (model, input, dimensions, encoding_format) tuple. Opt into Cloudflare AI Gateway caching by setting either header on the request:

When a response comes from the cache, AnyRouter echoes a X-AnyRouter-Cache-Status: HIT response header.

Response

{
  "id": "embd_req_01HXYZ...",
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023064255, -0.009327292, 0.015797347]
    }
  ],
  "model": "qwen/qwen3-embedding-8b",
  "usage": {
    "prompt_tokens": 9,
    "total_tokens": 9,
    "cost": 0.00000011
  }
}

Response headers

Encoding format

Request encoding_format: "base64" to reduce JSON payload size for large batches:

// float (default)
{ "embedding": [0.0023, -0.0235, 0.0456] }

// base64
{ "embedding": "AAAACgkJMzdG7y..." }

Dimensions

When the upstream supports it, request a truncated vector. Unsupported dimensions values are passed through and may be rejected upstream:

{
  "model": "qwen/qwen3-embedding-8b",
  "input": "Your text here",
  "dimensions": 512
}

Models

Pricing and live availability are listed on the Models page.

Examples

curl https://anyrouter.dev/api/v1/embeddings \
  -H "Authorization: Bearer $ANYROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3-embedding-8b",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

{
  "model": "qwen/qwen3-embedding-8b",
  "input": [
    "First text to embed",
    "Second text to embed",
    "Third text to embed"
  ]
}

const embed = (text: string | string[]) =>
  fetch("https://anyrouter.dev/api/v1/embeddings", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.ANYROUTER_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ model: "qwen/qwen3-embedding-8b", input: text }),
  }).then((r) => r.json())

const docs = await embed(documents) // batch
const query = await embed(userQuery) // single
const similarity = cosineSimilarity(query.data[0].embedding, docs.data[0].embedding)

Errors

Error responses follow the standard error contract.

Related

• Models — list and inspect every supported model
• Errors — status codes and fixes
• Smart Routing — provider preferences and fallback