Endpoints
Rerank
Sortera dokument efter relevans mot en fråga med POST /rerank, som andra steg i en sökpipeline eller RAG-flöde, med parametrar, exempel och prissättning.
Testa i playgroundSortera en lista med dokument efter relevans mot en fråga. Rerankers är det andra steget i en sökpipeline: hämta 50–200 kandidater med embeddings eller nyckelordssökning, rerank sedan och behåll de bästa få för din prompt.
POST https://api14.com/api/v1/rerank
De officiella OpenAI-SDK:erna har ingen rerank-metod, så anropa den med vanlig HTTP (alla språkexempel nedan gör det).
Anrop
| Parameter | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
model | string | ja | Ett rerank-modell-id, t.ex. cohere/rerank-v3.5. |
query | string | ja | Sökfrågan. |
documents | string[] | ja | Kandidattexter som ska poängsättas. |
top_n | integer | nej | Returnera bara de N bästa resultaten. Standard är alla. |
return_documents | boolean | nej | Inkludera dokumenttexten i varje resultat. |
Exempel
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api14.com/api/v1",
apiKey: process.env.API14_API_KEY,
});
const result = await client.post("/rerank", { body: {
"model": "cohere/rerank-v3.5",
"query": "What is the capital of France?",
"documents": [
"Paris is the capital of France.",
"Berlin is in Germany."
],
"top_n": 1
} });
console.log(result.results);
curl https://api14.com/api/v1/rerank \
-H "Authorization: Bearer sk-api14-..." \
-H "Content-Type: application/json" \
-d '{
"model": "cohere/rerank-v3.5",
"query": "How do I reset my password?",
"documents": [
"Billing happens on the first of each month.",
"To reset your password, open Settings and choose Security.",
"Our office is closed on public holidays."
],
"top_n": 2
}'
Svar
{
"id": "gen-1791100000-rr1",
"model": "cohere/rerank-v3.5",
"results": [
{ "index": 1, "relevance_score": 0.94 },
{ "index": 0, "relevance_score": 0.08 }
],
"usage": { "search_units": 1, "cost": 0.002 }
}
index pekar in i din documents-array. Resultaten sorteras efter relevance_score, högst först.
Priser
Rerank-modeller faktureras per sökning till modellens listade pris, som visas som "$ / 1K searches". Kostnaden finns i usage.cost och dras från ditt USD-saldo.
Lista rerank-modeller
curl "https://api14.com/api/v1/models?category=rerank"
Fel
| Status | Kod | När |
|---|---|---|
| 400 | model_required / invalid_json | model saknas eller så är innehållet felaktigt. |
| 402 | insufficient_balance | Ditt USD-saldo är 0 USD. |
| 403 | model_not_allowed | Nyckelns tillåtelselista utesluter modellen. |
| 404 | model_not_found | Okänt eller inaktiverat modell-id. |
| 429 | rate_limited | Gränsen för anrop per minut har överskridits. |
Se Fel.