aisplice

Riferimento API

Rerank

Nessun modello lo supporta ancora

Al momento nessun modello del catalogo supporta questa route. La pagina resta come riferimento.
POST/v1/rerank

Assegna 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

  • modelstringobbligatorio

    Identificatore esatto del modello di rerank, preso dal catalogo dei modelli aggiornato.

  • querystringobbligatorio

    La query o la domanda usata per assegnare il punteggio ai candidati.

  • documentsstring[]obbligatorio

    Passaggi candidati da ordinare. Mantieni il loro ordine originale nella tua applicazione.

  • top_nintegerfacoltativo

    Numero massimo di risultati ordinati da restituire.

  • return_documentsbooleanfacoltativo

    Se 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.

Tabella completa dei codici di errore →

#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.