Passer au contenu principal
POST
Rerank documents (Cohere v2-compatible)

Autorisations

Authorization
string
header
requis

A key from conare.ai/dashboard/keys with full access, some namespaces, or models only (/embed, /rerank, /v1, /v2/rerank, /parse).

Corps

application/json
query
string
requis
Minimum string length: 1
documents
(string | object)[]
requis

Up to 100 strings or { text } objects (1,000 on a custom reranker).

Required array length: 1 - 1000 elements
model
string

Omit for the default reranker.

top_n
integer

Return only the best top_n. Default all.

Plage requise: x >= 0
return_documents
boolean
défaut:false

Add each result's document text, as sent.

max_tokens_per_doc
integer

Truncate each document to about this many tokens (4 characters each). 0 is no limit.

Plage requise: x >= 0

Réponse

Scores, best first. index points into the request's documents.

id
string
requis

The request id.

model
string
requis
results
object[]
requis
unscored
integer[]
requis

Indexes of documents that were not scored. Usually empty.

usage
object
requis