Vi använder cookies. Cookies och webbläsarlagring håller dig inloggad och kommer ihåg dina preferenser. Med ditt tillstånd mäter vi också hur webbplatsen används. Du kan när som helst. Läs vår cookiepolicy.

Rerank

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 playground

Sortera 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

ParameterTypObligatoriskBeskrivning
modelstringjaEtt rerank-modell-id, t.ex. cohere/rerank-v3.5.
querystringjaSökfrågan.
documentsstring[]jaKandidattexter som ska poängsättas.
top_nintegernejReturnera bara de N bästa resultaten. Standard är alla.
return_documentsbooleannejInkludera 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

StatusKodNär
400model_required / invalid_jsonmodel saknas eller så är innehållet felaktigt.
402insufficient_balanceDitt USD-saldo är 0 USD.
403model_not_allowedNyckelns tillåtelselista utesluter modellen.
404model_not_foundOkänt eller inaktiverat modell-id.
429rate_limitedGränsen för anrop per minut har överskridits.

Se Fel.