POST
/
rerank

This feature is in public preview.

The rerank endpoint is only available to organizations on the Standard or Enterprise plans.

To use the Inference API with the Python SDK, upgrade the SDK and install the pinecone-plugin-inference package as follows:

pip install --upgrade pinecone 
pip install --upgrade --pre pinecone-plugin-inference==1.1.0.*

Authorizations

Api-Key
string
headerrequired

An API Key is required to call Pinecone APIs. Get yours from the console.

Body

application/json
model
string
required

Model to use for reranking.

query
string
required

The query to rerank documents against.

top_n
integer

The number of results to return sorted by relevance. Defaults to the number of inputs.

return_documents
boolean
default: true

Whether to return the documents in the response.

rank_fields
string[]

The fields to rank the documents by. If not provided the default is text.

documents
object[]
required

The documents to rerank.

parameters
object

Additional model specific parameters for the reranker.

Response

200 - application/json
model
string
required

The model used for reranking

data
object[]
required

The reranked documents

usage
object
required

Usage statistics for the inference

Was this page helpful?