---
title: "Rank a list of passages based on their relevance to a given input text using a cross-encoder model."
method: POST
path: "/cross-encoders"
tags: ["Cross-Encoders"]
---

# Rank a list of passages based on their relevance to a given input text using a cross-encoder model.

`POST /cross-encoders`

## Request body

- CrossEncodersRequest
  - `provider` string, required
  - `model` string, required
  - `input` string, required
  - `passages` string[], required

## Response `200`

response

- union
  - CrossEncodersResponse
    - `ok` boolean
    - `data` number[]
  - Error
    - `error` boolean
    - `message` string[]

---

[API](https://skmtc.net/aws-samples/apis/gaia-rest-api.md) · [All operations](https://skmtc.net/aws-samples/apis/gaia-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/gaia-rest-api/revisions/c61f71119116/schema)