Riferimento API
Rerank
Nessun modello lo supporta ancora
Al momento nessun modello del catalogo supporta questa route. La pagina resta come riferimento.
POST
/v1/rerankAssegna un punteggio a un elenco di documenti candidati rispetto a una query. I risultati vengono restituiti in ordine di pertinenza decrescente e mantengono l'indice originale di ogni documento.
#Parametri della richiesta
modelstringobbligatorioIdentificatore esatto del modello di rerank, preso dal catalogo dei modelli aggiornato.
querystringobbligatorioLa query o la domanda usata per assegnare il punteggio ai candidati.
documentsstring[]obbligatorioPassaggi candidati da ordinare. Mantieni il loro ordine originale nella tua applicazione.
top_nintegerfacoltativoNumero massimo di risultati ordinati da restituire.
return_documentsbooleanfacoltativoSe supportato, include il testo del documento in ogni risultato.
#Errori correlati
- 400 invalid_request_errorquery o documents manca, è vuoto o non è supportato da questo modello.
- 401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
- 402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
- 429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
- 503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.
#Esempio di richiesta
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
}'#Risposta
response.json
{
"results": [
{ "index": 0, "relevance_score": 0.9821 },
{ "index": 1, "relevance_score": 0.1034 }
]
}Non hai ancora risolto?
Inviaci l'ID richiesta o il messaggio di errore e verificheremo.