Référence API

Reranking

Aucun modèle disponible pour l'instant

Aucun modèle du catalogue ne prend en charge cette route actuellement. La page reste disponible pour référence.
POST/v1/rerank

Attribue un score à une liste de documents candidats par rapport à une requête. Les résultats sont renvoyés par pertinence décroissante et conservent l'index d'origine de chaque document.

#Paramètres de la requête

  • modelstringobligatoire

    Identifiant exact du modèle de reranking, issu du catalogue de modèles en direct.

  • querystringobligatoire

    La requête de recherche ou la question utilisée pour noter les candidats.

  • documentsstring[]obligatoire

    Passages candidats à classer. Conservez leur ordre d'origine dans votre application.

  • top_nintegerfacultatif

    Nombre maximal de résultats classés à renvoyer.

  • return_documentsbooleanfacultatif

    Si pris en charge, inclut le texte du document dans chaque résultat.

#Erreurs associées

  • 400 invalid_request_errorquery ou documents est manquant, vide ou non pris en charge par ce modèle.
  • 401Jeton bearer invalide ou manquant. Pas de error.code sur ce chemin — basez-vous sur le statut.
  • 402 insufficient_user_quotaLe solde du portefeuille ne couvre pas l'estimation préréservée.
  • 429Limitation par clé. Corps vide ; attendez Retry-After. Un 429 qui contient insufficient_user_quota correspond en revanche à un plafond de dépenses quotidien.
  • 503 model_not_foundModèle inconnu, ou aucun canal opérationnel ne le sert actuellement.

Table complète des codes d'erreur →

#Exemple de requête

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
  }'

#Réponse

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

Toujours bloqué ?

Envoyez-nous l'ID de requête ou le message d'erreur, et nous examinerons le problème.