Jina Rerank

Переранжируйте документы-кандидаты с помощью структуры запросов Rerank в стиле Jina AI.

Интерфейс Jina Rerank ранжирует документы-кандидаты по релевантности тексту запроса и возвращает исходные документы, индексы, оценки релевантности и статистику использования Tokens. Запросы и ответы используют структуру полей в стиле Jina AI.

POST/v1/rerank

Вычислите релевантность документов-кандидатов тексту запроса и получите результаты в порядке релевантности. AGTCloud возвращает результаты в стиле Jina AI; ответы некоторых совместимых интерфейсов также преобразуются в эту структуру.

Запросы и документы могут быть на разных языках. Для более стабильного ранжирования используйте ясные и конкретные запросы, сохраняйте целостность документов и не превышайте предел Tokens выбранной модели для одного документа. Большие объёмы документов рекомендуется обрабатывать пакетами; результаты стабильных повторяющихся запросов можно кэшировать в приложении.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

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

Определения типов TypeScript

Используйте тип request body в TypeScript.

model?string

ID модели переранжирования, например jina-reranker-v2-base-multilingual. Используйте модель, доступную текущему аккаунту.

query*string

Текст запроса для ранжирования документов-кандидатов по релевантности. Рекомендуются ясные и конкретные запросы; близкие языковые формулировки запроса и документов обычно повышают стабильность результата.

top_n?integer

Вернуть первые N документов с наибольшей релевантностью. Если значение не указано, количество результатов не ограничивается; разумное ограничение сокращает лишнюю передачу и обработку результатов.

documents*array<string>

Список документов для переранжирования. Каждый документ должен быть целостным, однозначным по смыслу и не превышать максимальное число Tokens выбранной модели; большие объёмы рекомендуется обрабатывать пакетами. Список может содержать тексты на разных языках.

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/rerank" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "query": "Органические средства ухода за чувствительной кожей",    "top_n": 3,    "documents": [      "Органический уход за чувствительной кожей с алоэ вера и ромашкой...",      "Новые тенденции макияжа делают акцент на ярких цветах и инновационных техниках...",      "Bio-Hautpflege für empfindliche Haut mit Aloe Vera und Kamille..."    ]  }'

{
  "results": [
    {
      "document": {
        "text": "Органический уход за чувствительной кожей с алоэ вера и ромашкой..."
      },
      "index": 0,
      "relevance_score": 0.8783142566680908
    },
    {
      "document": {
        "text": "Bio-Hautpflege für empfindliche Haut mit Aloe Vera und Kamille..."
      },
      "index": 2,
      "relevance_score": 0.762467586994171
    }
  ],
  "usage": {
    "prompt_tokens": 815,
    "completion_tokens": 0,
    "total_tokens": 815
  }
}

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`