Source: https://ailoot.ai/models/it/voyageai-rerank-2-5-lite/
Canonical: https://ailoot.ai/models/it/voyageai-rerank-2-5-lite/
Language: it

# VoyageAI by MongoDB: rerank-2.5-lite

[Markdown](https://ailoot.ai/models/it/voyageai-rerank-2-5-lite/index.md) · [JSON](https://ailoot.ai/models/it/voyageai-rerank-2-5-lite/facts.json)

## [VoyageAI by MongoDB: rerank-2.5-lite](https://ailoot.ai/models/it/voyageai-rerank-2-5-lite/)

rerank-2.5-lite è il reranker di Voyage AI orientato alla latenza che segue istruzioni per un insieme fornito di candidati testuali. Mantiene un contesto query-documento di 32.000 token e il supporto multilingue, restituendo un elenco ordinato di punteggi di pertinenza e indici dei documenti originali.

- [**Ailoot Ultra · Riordinamento** `POST /v1/rerank` `voyageai/rerank-2.5-lite`](https://ailoot.ai/models/it/voyageai-rerank-2-5-lite/#method-0)

Informazioni sul modello

Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.

rerank-2.5-lite è il membro leggero del rilascio 2.5 dei reranker di Voyage AI. Il produttore lo descrive come un modello generalista che bilancia latenza e qualità della pertinenza, con rispetto delle istruzioni in linguaggio naturale e supporto multilingue. Il suo input è una query e testi candidati, e il suo output è un ordine perfezionato di quei candidati con punteggi di pertinenza.

#### Una valutazione leggera della pertinenza nella seconda fase

Il modello Lite elabora congiuntamente ogni coppia query-documento come cross-encoder. Può seguire una ricerca iniziale basata su embedding o lessico, perfezionando i brani selezionati da quella fase. Questo differisce dalla preparazione di un indice di embedding riutilizzabile: il reranker esamina insieme la query inviata e il testo del documento per la valutazione corrente della pertinenza.

Per una ricerca interattiva di assistenza, invia le spiegazioni candidate che potrebbero rispondere alla domanda dell'utente. Mantieni abbastanza testo di ogni brano da comunicare il comportamento e le relative condizioni e conserva l'associazione tra l'indice di input e l'elemento originale. Un insieme di candidati mirato aiuta a rendere chiaro il compito di reranking, lasciando le prove recuperate utilizzabili per la visualizzazione o una risposta successiva.

#### Le istruzioni esprimono cosa l'utente vuole privilegiare

Come rerank-2.5, Lite accetta istruzioni in linguaggio naturale prima o dopo la query. Gli esempi del produttore le usano per evidenziare componenti del documento, selezionare un tipo preferito di fonte o aggiungere contesto a una parola ambigua. Un'applicazione può fornire una preferenza di pertinenza stabile, oppure la domanda corrente può includerne una più specifica.

Una query di supporto esemplificativa può chiedere quale brano spieghi un errore, con l'istruzione di dare priorità ai passaggi di risoluzione dei problemi rispetto alle descrizioni generali del prodotto. Una ricerca documentale può chiedere la formulazione originale di una policy invece di una discussione della policy. Descrivi le prove desiderate e mantieni l'istruzione concisa. Le istruzioni influenzano i punteggi di pertinenza; applica ogni vincolo rigido su versione, data o autorizzazione nella selezione dei candidati, invece di trattare una preferenza di pertinenza come filtro garantito.

#### Leggi la classifica e restituisci il brano originale

L'output è ordinato per pertinenza decrescente. Ogni risultato include l'indice originale del documento e un punteggio a virgola mobile; l'impostazione opzionale return-documents restituisce anche il testo di input corrispondente. L'opzione top-k determina il numero dei primi risultati restituiti, mentre ometterla restituisce la classifica di tutti i candidati inviati.

Usa quegli indici per recuperare il brano originale e il suo identificatore. Un candidato riclassificato può diventare un risultato di ricerca o una prova per il passaggio RAG successivo, ma l'output è un ordinamento del testo fornito, non una risposta riscritta. Valuta se i brani ai primi posti soddisfano sia la domanda sia l'istruzione di pertinenza, anche nelle lingue e nei tipi di documenti effettivamente presenti nella raccolta.

#### Limiti e un budget pratico dei candidati

L'edizione 2.5 Lite ha un massimo documentato di 8.000 token per la query e un limite di 32.000 token per la query più ogni singolo documento. È distinta dal precedente modello rerank-2-lite e dal suo contesto più piccolo. Si possono inviare al massimo 1.000 documenti e l'input totale è limitato a 600.000 token secondo la formula: token della query moltiplicati per il numero di candidati, più la somma dei token dei documenti candidati.

Per usi sensibili alla latenza, le FAQ del produttore raccomandano rerank-2.5-lite con non più di 200.000 token totali per richiesta. È un'indicazione pratica al di sotto del massimo dichiarato, non una diversa finestra per documento. Una query o istruzione più lunga viene contata una volta per ogni coppia candidata, quindi sia il numero di candidati sia la lunghezza della query influiscono sul totale.

Il troncamento è abilitato per impostazione predefinita e accorcia input query/documento troppo lunghi per farli rientrare; disabilitarlo restituisce un errore per una query o una coppia troppo lunga. Prepara deliberatamente candidati compatti che contengano la risposta, così le prove utili non restano oltre il limite di troncamento. Selezionare meno risultati di output tramite top-k non rimuove gli altri candidati forniti dal calcolo dei token. Esamina i brani originali restituiti e perfeziona la preparazione dell'input intorno alle domande effettive a cui l'interfaccia di ricerca deve rispondere.

**Ailoot Ultra · Riordinamento** `POST /v1/rerank` `voyageai/rerank-2.5-lite`

[`voyageai/rerank-2.5-lite`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-2.5-lite&route=Ultra&caller=voyageai%2Frerank-2.5-lite&fmt=rerank)

VoyageAI by MongoDB /`voyageai/rerank-2.5-lite`

### Introduzione

rerank-2.5-lite è il reranker di Voyage AI orientato alla latenza che segue istruzioni per un insieme fornito di candidati testuali. Mantiene un contesto query-documento di 32.000 token e il supporto multilingue, restituendo un elenco ordinato di punteggi di pertinenza e indici dei documenti originali.

Input accettati

Testo

Risultati

Risultati ordinati

### Disponibile in Ailoot · input e metodi

**Ailoot Ultra · Riordinamento** `POST /v1/rerank`

Tipi di input

`text`

Tipi di output

`rerank`

Formato di output

json

| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
| --- | --- | --- | --- | --- |
| Campo`documents` | Tipo`array` | RequisitoObbligatorio | Valori e limiti | Predefinito— |
| Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti voyageai/rerank-2.5-lite | Predefinito— |
| Campo`provider` | Tipo`schema` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`query` | Tipo`string` | RequisitoObbligatorio | Valori e limiti | Predefinito— |
| Campo`session_id` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`top_n` | Tipo`integer` | RequisitoFacoltativo | Valori e limiti Minimo: 1 | Predefinito— |
| Campo`trace` | Tipo`schema` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`user` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`documents[].text` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— |
| Campo`documents[].image` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— |

Combinazioni di materiali in input

**text\_rerank** · Obbligatorio: query, documents array with minItems1

Parametri e ciclo di vita del metodo

| Parametro | Contratto |
| --- | --- |
| Parametro`content_type` | Contrattoapplication/json |
| Parametro`required` | Contrattomodel, query, documents |
| Parametro`material_types` | Contrattotext |
| Parametro`optional_controls` | Contrattoprovider, session\_id, top\_n, trace, user |
| Parametro`multimodal_input_binding` | Contrattonull |

Ciclo di vita: `synchronous`

Invia l'ID esatto del modello e conserva l'intera risposta nativa.

### Tariffe

Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.

Modalità rapida

Non specificato Quando è selezionata la modalità rapida

Modalità flex

Non specificato Quando è selezionata la modalità flex

Sforzo massimo di ragionamento

Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)

#### Tariffe Ailoot

#### Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

| Configurazione | Listino delle tariffe | Unità di fatturazione | Costo |
| --- | --- | --- | --- |
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Unità di fatturazione— | Costo Input · Token in input **—** / 1K token Output · Token in output **—** / 1K token Input · Lettura dalla cache **—** / 1K token Input · Scrittura nella cache **—** / 1K token Input · Scrittura nella cache, 1 ora **—** / 1K token |
| ConfigurazioneUltra | Listino delle tariffe— | Unità di fatturazione/ 1K token | Costo Input **$0.00004** / 1K token |

Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. [Come funzionano la prenotazione e l’addebito finale →](https://ailoot.ai/docs/it/billing/reserve/)

### Esempi di richieste

#### Ailoot Ultra · Riordinamento

Struttura ufficiale della richiesta conservata; esempio per la documentazioneUsa il materiale effettivo della tua richiesta e conserva il risultato completo

```json
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-2.5-lite",
  "query": "What is the capital of France?",
  "top_n": 3
}
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='voyageai/rerank-2.5-lite'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
```

### Ricevi e salva i risultati

#### Ailoot Ultra · Riordinamento

json

##### Conserva tutti i risultati completati

Conserva ogni risposta, file e parte di contenuto restituiti per intero.

Vengono conservati ogni indice effettivo dei risultati, ogni relevance\_score finito e l'oggetto documento originale. Gli indici corrispondono all'array di documenti originale. L'intero JSON originale viene memorizzato e restituito solo dopo il conguaglio dell'addebito.

##### Se occorre verificare la risposta originale

Conserva l'operazione originale e la risposta completa o parziale; non ripetere POST.

Campi della risposta

| Campo | Tipo |
| --- | --- |
| Campo`model` | Tipostring |
| Campo`id` | Tipostring |
| Campo`provider` | Tipostring |
| Campo`results[].index` | Tipointeger |
| Campo`results[].relevance_score` | Tiponumber |
| Campo`results[].document.text` | Tipostring |
| Campo`results[].document.image` | Tipostring |
| Campo`usage.search_units` | Tipointeger |
| Campo`usage.total_tokens` | Tipointeger |
| Campo`usage.cost` | Tiponumber |

Errori e passaggi successivi

| Risposta | Condizione | Passaggio successivo |
| --- | --- | --- |
| Risposta400 · `invalid_request_error` | CondizioneCampo obbligatorio, rappresentazione o valore non valido | Passaggio successivoCorreggi il campo della richiesta indicato. |

### Alias

#### Alias del modello

**Ailoot Ultra** [`voyageai/rerank-2.5-lite`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-2.5-lite&route=Ultra&caller=voyageai%2Frerank-2.5-lite&fmt=rerank)

#### Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

#### ID di chiamata correlati

[`voyageai/rerank-2.5-lite`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-2.5-lite&route=Ultra&caller=voyageai%2Frerank-2.5-lite&fmt=rerank)

FAQ · VoyageAI by MongoDB: rerank-2.5-lite

Quali input e risultati sono disponibili?

`POST /v1/rerank` · `voyageai/rerank-2.5-lite`: `text` → `rerank`

Quali campi usa la richiesta?

`POST /v1/rerank` · `voyageai/rerank-2.5-lite`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user`

Quali limiti si applicano?

`POST /v1/rerank` · `voyageai/rerank-2.5-lite`: `top_n.minimum`: `1`

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

## L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

## Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento

Scegli un piano scontato per richieste regolari.

Codice fino al 50%

Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.

Spese nella cronologia

Modello, token e importo sono salvati per ogni richiesta.

[Scegli abbonamento](https://ailoot.ai/docs/it/billing/subscriptions/) · [Consulta prezzi dei modelli](https://ailoot.ai/models/it/)

## Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale

Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.

Licenza reseller

Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.

Documenti sul sito

Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

[Richiedi licenza reseller](mailto:support@ailoot.ai) · [Offerta e accordo di licenza](https://ailoot.ai/legal/offer?lang=it)

## Ailoot · L’azienda e il suo portafoglio di progetti





Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.





L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.





Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.
