Create Embeddings

Generate embedding vectors for one or many text inputs.

POST/v1/embeddings

Request Parameters

Name	Type	Required	Description
model	string	Required	Embedding model identifier.
input	string \| string[]	Required	Input text or array of text strings. Arrays support up to 2,048 items.
encoding_format	string		Output format: float or base64.
dimensions	integer		Optional reduced dimensions when supported.
user	string		Unique identifier for the end-user. Forwarded to the provider.

Request Example

bash

curl -X POST https://api.therouter.ai/v1/embeddings
  -H "Authorization: Bearer $THEROUTER_API_KEY"
  -H "Content-Type: application/json"
  -d '{
    "model": "openai/text-embedding-3-large",
    "input": ["therouter", "routing"]
  }'

Response

json

{
  "object": "list",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.012, -0.035, 0.221]},
    {"object": "embedding", "index": 1, "embedding": [0.017, -0.029, 0.198]}
  ],
  "model": "openai/text-embedding-3-large",
  "usage": {"prompt_tokens": 4, "total_tokens": 4}
}

Notes

Batch inputs are returned in-order using the index field.