Rerank documents (Cohere v2-compatible)
curl --request POST \
--url https://api.conare.ai/v2/rerank \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "refund window",
"documents": [
"Orders ship within two days.",
{
"text": "Refunds are available for 30 days."
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: 'refund window',
documents: ['Orders ship within two days.', {text: 'Refunds are available for 30 days.'}]
})
};
fetch('https://api.conare.ai/v2/rerank', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.conare.ai/v2/rerank"
payload = {
"query": "refund window",
"documents": ["Orders ship within two days.", { "text": "Refunds are available for 30 days." }]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04",
"model": "conare-rerank-1",
"results": [
{
"index": 1,
"relevance_score": 0.87
}
],
"unscored": [],
"usage": {
"total_tokens": 812
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}Models
Rerank documents (Cohere v2-compatible)
Cohere’s v2 rerank API for its ClientV2: the same request and answer as /v1/rerank.
POST
https://api.conare.ai
/
v2
/
rerank
Rerank documents (Cohere v2-compatible)
curl --request POST \
--url https://api.conare.ai/v2/rerank \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "refund window",
"documents": [
"Orders ship within two days.",
{
"text": "Refunds are available for 30 days."
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
query: 'refund window',
documents: ['Orders ship within two days.', {text: 'Refunds are available for 30 days.'}]
})
};
fetch('https://api.conare.ai/v2/rerank', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.conare.ai/v2/rerank"
payload = {
"query": "refund window",
"documents": ["Orders ship within two days.", { "text": "Refunds are available for 30 days." }]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04",
"model": "conare-rerank-1",
"results": [
{
"index": 1,
"relevance_score": 0.87
}
],
"unscored": [],
"usage": {
"total_tokens": 812
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}{
"error": {
"code": "invalid_request",
"message": "text is required",
"request_id": "7d0f4c1e-2b8a-4e39-9a61-3c5e8b2f9d04"
}
}Authorizations
A key from conare.ai/dashboard/keys with full access, some namespaces, or models only (/embed, /rerank, /v1, /v2/rerank, /parse).
Body
application/json
Minimum string length:
1Up to 100 strings or { text } objects (1,000 on a custom reranker).
Required array length:
1 - 1000 elementsOmit for the default reranker.
Return only the best top_n. Default all.
Required range:
x >= 0Add each result's document text, as sent.
Truncate each document to about this many tokens (4 characters each). 0 is no limit.
Required range:
x >= 0Was this page helpful?