Uç noktalar
Rerank
POST /rerank ile belgeleri bir sorguya göre alaka düzeyine sıralayın; arama hattınızın ikinci aşaması için parametreler, örnekler ve fiyatlandırma.
Playground’da deneBir belge listesini bir sorguya olan alakasına göre sıralayın. Reranker'lar bir arama hattının ikinci aşamasıdır: embedding'ler veya anahtar kelime aramasıyla 50 ila 200 aday getirin, sonra yeniden sıralayıp prompt'unuz için en iyi birkaçını tutun.
POST https://api14.com/api/v1/rerank
Resmi OpenAI SDK'larında rerank metodu yoktur; bu yüzden düz HTTP ile çağırın (aşağıdaki her dil örneği böyle yapar).
İstek
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
model | string | evet | Bir rerank model kimliği, örn. cohere/rerank-v3.5. |
query | string | evet | Arama sorgusu. |
documents | string[] | evet | Puanlanacak aday metinler. |
top_n | integer | hayır | Yalnızca en iyi N sonucu döndürür. Varsayılan hepsidir. |
return_documents | boolean | hayır | Her sonuca belge metnini ekler. |
Örnek
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
}'
Yanıt
{
"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, documents dizinizdeki konumu gösterir. Sonuçlar relevance_score değerine göre, en yüksek ilk sırada olacak şekilde sıralanır.
Fiyatlandırma
Rerank modelleri, modelin listelenen fiyatı üzerinden arama başına faturalandırılır ve "$ / 1K arama" olarak gösterilir. Maliyet usage.cost alanındadır ve USD bakiyenizden düşülür.
Rerank modellerini listeleme
curl "https://api14.com/api/v1/models?category=rerank"
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 400 | model_required / invalid_json | model eksik veya gövde hatalı. |
| 402 | insufficient_balance | USD bakiyeniz 0. |
| 403 | model_not_allowed | Anahtar izin listesi modeli dışlıyor. |
| 404 | model_not_found | Bilinmeyen veya devre dışı model kimliği. |
| 429 | rate_limited | Dakikalık istek limiti aşıldı. |
Bkz. Hatalar.