Документация / API

Поиск и ранжирование

Векторные представления текста и ранжирование документов по запросу.

Модели эмбеддингов →Модели ранжирования →

Эмбеддинги переводят текст в векторы для поиска по смыслу; ранжирование упорядочивает документы по запросу.

POST/v1/embeddings

Create embeddings

Ключ: заголовок Authorization: Bearer <ключ>. Как получить ключ →

Тело запроса

application/json

dimensionsinteger
encoding_formatstring
Значения: float, base64
inputstring | array of stringобязательное
Text or texts.
modelstringобязательное
Остальные поля формата OpenRouter передаются модели без изменений.

Пример запроса

{
  "input": "The quick brown fox",
  "model": "openai/text-embedding-3-small"
}

Ответ 200

Embeddings.

dataarray of objectобязательное
- embeddingarray of number
- indexinteger
- objectstring
modelstring
objectstring
usageobject
- completion_tokensinteger
- costnumber | null
  Amount actually charged, in roubles with five decimals (thousandths of a kopeck). null while the provider cost is being fetched (pending) or the charge is under review.
- cost_statusstring
  final — charged by the provider's actual cost; estimated — by our price table; pending — the cost is being fetched, the charge follows; review — an operator decides.
  Значения: final, estimated, pending, review
- prompt_tokensinteger
- total_tokensinteger
Остальные поля формата OpenRouter передаются модели без изменений.

Пример ответа

{
  "data": [
    {
      "embedding": [
        0.0123,
        -0.0456
      ],
      "index": 0,
      "object": "embedding"
    }
  ],
  "model": "openai/text-embedding-3-small",
  "object": "list",
  "usage": {
    "cost": 0.00009,
    "cost_status": "final",
    "prompt_tokens": 5,
    "total_tokens": 5
  }
}

Ошибки

400The request is invalid or its cost cannot be bounded in advance. Nothing is charged.
401Missing or invalid API key.
402The balance does not cover the reserve of this request.
403The input was flagged by moderation; metadata.reasons lists why.
404The model provider rejected the request (its status is kept: 400, 404, 413 or 422); metadata.provider_message, when present, is the provider's explanation.
413The model provider rejected the request (its status is kept: 400, 404, 413 or 422); metadata.provider_message, when present, is the provider's explanation.
422The model provider rejected the request (its status is kept: 400, 404, 413 or 422); metadata.provider_message, when present, is the provider's explanation.
429Too many requests, or the model provider is busy. Retry-After, when present, says when to retry.
502The model provider failed or returned an error.
503Billing or the model provider is temporarily unavailable.

Формат тела ошибки и что делать — Лимиты и ошибки.

POST/v1/rerank

Rerank documents