Submit an embedding request | OpenRouter

import requests
url = "https://openrouter.ai/api/v1/embeddings"
payload = {
    "input": "The quick brown fox jumps over the lazy dog",
    "model": "text-embedding-ada-002"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "embedding": [
        0.0123,
        -0.0456,
        0.0789,
        -0.0345,
        0.0678,
        -0.0234,
        0.0567,
        -0.089,
        0.0345,
        -0.0123
      ],
      "index": 0
    }
  ],
  "model": "text-embedding-ada-002",
  "id": "embeddings-1234567890abcdef",
  "usage": {
    "prompt_tokens": 9,
    "total_tokens": 9,
    "cost": 0.00015
  }
}

Submits an embedding request to the embeddings router

Authentication

AuthorizationBearer

API key as bearer token in Authorization header

Request

This endpoint expects an object.

inputstring or list of strings or list of doubles or list of lists of doubles or list of objectsRequired

modelstringRequired

encoding_formatenumOptional

Allowed values:

dimensionsintegerOptional>=0

userstringOptional

providerobjectOptional

Provider routing preferences for the request.

input_typestringOptional

Response

Embedding response

objectenum

Allowed values:

datalist of objects

modelstring

idstring

usageobject

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error