---
title: "watsonx.ai Rerank"
description: "| Property | Details | |----------|--------------------------------------------------------------------------| | Description | watsonx.ai rerank integration | | Provider Route on LiteLLM | `watsonx/` | | Supported Operations | `/ml/v1/text/rerank` | | Link to Provider Doc | [IBM WatsonX.ai ↗](https://cloud.ibm.com/apidocs/watsonx-ai#text-rerank) |"
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/rerank-1
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:46:04.709Z
license: CC-BY-4.0
attribution: "watsonx.ai Rerank — Claudary (https://claudary.paisolsolutions.com/skills/rerank-1)"
---

# watsonx.ai Rerank
| Property | Details | |----------|--------------------------------------------------------------------------| | Description | watsonx.ai rerank integration | | Provider Route on LiteLLM | `watsonx/` | | Supported Operations | `/ml/v1/text/rerank` | | Link to Provider Doc | [IBM WatsonX.ai ↗](https://cloud.ibm.com/apidocs/watsonx-ai#text-rerank) |

## Overview

# watsonx.ai Rerank

## Overview

| Property | Details                                                                  |
|----------|--------------------------------------------------------------------------|
| Description | watsonx.ai rerank integration                                            |
| Provider Route on LiteLLM | `watsonx/`                                                               |
| Supported Operations | `/ml/v1/text/rerank`                                                     |
| Link to Provider Doc | [IBM WatsonX.ai ↗](https://cloud.ibm.com/apidocs/watsonx-ai#text-rerank) |

## Quick Start

### **LiteLLM SDK**

```python
import os
from litellm import rerank

os.environ["WATSONX_APIKEY"] = "YOUR_WATSONX_APIKEY"
os.environ["WATSONX_API_BASE"] = "YOUR_WATSONX_API_BASE"
os.environ["WATSONX_PROJECT_ID"] = "YOUR_WATSONX_PROJECT_ID"

query="Best programming language for beginners?"
documents=[
    "Python is great for beginners due to simple syntax.",
    "JavaScript runs in browsers and is versatile.",
    "Rust has a steep learning curve but is very safe.",
]

response = rerank(
    model="watsonx/cross-encoder/ms-marco-minilm-l-12-v2",
    query=query,
    documents=documents,
    top_n=2,
    return_documents=True,
)

print(response)
```

### **LiteLLM Proxy**

```yaml
model_list:
  - model_name: cross-encoder/ms-marco-minilm-l-12-v2
    litellm_params:
      model: watsonx/cross-encoder/ms-marco-minilm-l-12-v2
      api_key: os.environ/WATSONX_APIKEY
      api_base: os.environ/WATSONX_API_BASE
      project_id: os.environ/WATSONX_PROJECT_ID
```

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/rerank-1) · https://claudary.paisolsolutions.com