aisplice

API-Referenz

Reranking

Noch kein Modell verfügbar

Derzeit unterstützt kein Modell im Modellkatalog diese Route. Die Seite bleibt als Referenz erhalten.
POST/v1/rerank

Bewertet eine Liste von Kandidatendokumenten anhand einer Suchanfrage. Die Ergebnisse kommen nach absteigender Relevanz sortiert zurück und behalten den ursprünglichen Index jedes Dokuments.

#Anfrageparameter

  • modelstringerforderlich

    Exakte Kennung des Rerank-Modells aus dem aktuellen Modellkatalog.

  • querystringerforderlich

    Die Suchanfrage oder Frage, anhand derer die Kandidaten bewertet werden.

  • documentsstring[]erforderlich

    Zu sortierende Kandidatenpassagen. Behalten Sie deren ursprüngliche Reihenfolge in Ihrer Anwendung bei.

  • top_nintegeroptional

    Maximale Anzahl zurückgegebener Ergebnisse.

  • return_documentsbooleanoptional

    Sofern unterstützt, den Dokumenttext in jedes Ergebnis aufnehmen.

#Zugehörige Fehler

  • 400 invalid_request_errorquery oder documents fehlt, ist leer oder wird von diesem Modell nicht unterstützt.
  • 401Ungültiges oder fehlendes Bearer-Token. Auf diesem Pfad gibt es kein error.code — werten Sie den Status aus.
  • 402 insufficient_user_quotaDas Wallet-Guthaben deckt die vorab reservierte Schätzung nicht.
  • 429Drosselung pro Schlüssel. Leerer Body; warten Sie Retry-After ab. Ein 429, das insufficient_user_quota enthält, ist dagegen ein tägliches Ausgabenlimit.
  • 503 model_not_foundUnbekanntes Modell, oder derzeit bedient es kein funktionsfähiger Kanal.

Vollständige Fehlercode-Tabelle →

#Beispielanfrage

curl https://www.aisplice.store/v1/rerank \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RERANK_MODEL",
    "query": "What is the capital of France?",
    "documents": [
      "Paris is the capital of France.",
      "Berlin is in Germany."
    ],
    "top_n": 2
  }'

#Antwort

response.json
{
  "results": [
    { "index": 0, "relevance_score": 0.9821 },
    { "index": 1, "relevance_score": 0.1034 }
  ]
}

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.