multi-qa-mpnet-base-dot-v1 è un modello di Sentence Transformers progettato per recuperare passaggi testuali per una domanda o una query. Il suo addestramento ha usato circa 215 milioni di coppie domanda–risposta. Ogni input diventa un vettore denso a 768 dimensioni, con pooling CLS e punteggio tramite prodotto scalare che definiscono questa esatta edizione.
Scrivi la query come bisogno informativo e prepara le voci del corpus come passaggi testuali leggibili. Per esempio, una domanda sulla modifica di un indirizzo di consegna può essere confrontata con paragrafi separati su cambi di indirizzo, annullamento dell’ordine e tracciamento della consegna. Mantieni le condizioni pertinenti nel passaggio sul cambio di indirizzo, compreso il fatto che l’ordine sia già stato spedito o meno.
Codifica query e passaggi con questo stesso modello. L’esempio pubblicato lo fa direttamente, senza un prefisso di query o documento, e ordina i passaggi secondo i punteggi del prodotto scalare. Mantieni ogni vettore collegato al passaggio originale e all’identificatore del documento, affinché il risultato ordinato possa mostrare il materiale effettivamente indicizzato.
La ricetta di riferimento del modello prende la rappresentazione del primo token, nota come pooling CLS. La sua tabella tecnica afferma esplicitamente che gli embedding non sono normalizzati e indica il prodotto scalare come funzione di punteggio adatta. Preserva quella ricetta quando imposti la raccolta e il lato delle query.
La normalizzazione L2 di questi vettori ne cambia la geometria dei punteggi. Il profilo normalizzato all-mpnet-base-v2 usa una ricetta diversa ed è un checkpoint separato, nonostante condivida la famiglia MPNet e un output a 768 componenti. Mantieni l’edizione esatta e la funzione di confronto insieme alla raccolta memorizzata, anziché sceglierle soltanto dalla lunghezza dei vettori.
Il limite di input dichiarato è di 512 unità subword; il testo più lungo viene troncato. Il produttore osserva inoltre che gli input di addestramento raggiungevano soltanto 250 unità subword e che il testo più lungo può funzionare meno bene. La lunghezza accettata dal tokenizer e l’avvertenza sulla lunghezza di addestramento descrivono quindi confini pratici differenti.
Per un articolo di aiuto esteso, prepara sezioni brevi che rispondano a domande specifiche. Conserva un titolo quando identifica l’argomento e mantieni una regola con l’eccezione necessaria per leggerla correttamente. Un unico input di pagina intera può perdere materiale successivo per troncamento, mentre un frammento troppo piccolo può perdere la condizione che lo rende utile.
I vettori densi supportano una prima fase di recupero. Restituisci i passaggi candidati con i punteggi più alti insieme ai riferimenti alle fonti, quindi esamina se affrontano la domanda effettiva. In un flusso RAG, fornisci quei passaggi come materiale di origine alla fase di scrittura della risposta; il recupero stesso non compone la risposta.
Usa domande rappresentative con passaggi pertinenti noti per scegliere il numero di risultati e valutare l’ordinamento. Includi esempi con vocabolario simile ma intento diverso, come modificare un indirizzo rispetto a visualizzare quello attuale. Interpreta i punteggi relativamente ai candidati sotto lo stesso modello e la stessa configurazione di punteggio, anziché come probabilità calibrate di correttezza.
L’output utile di questo checkpoint è uno spazio di embedding per domande e passaggi destinato alla ricerca semantica. Vettori non normalizzati, pooling CLS, punteggio a prodotto scalare e l’avvertenza pubblicata sugli input lunghi sono i dettagli da preservare quando si preparano e si usano i risultati.
", "aboutText": "multi-qa-mpnet-base-dot-v1 è un modello di Sentence Transformers progettato per recuperare passaggi testuali per una domanda o una query. Il suo addestramento ha usato circa 215 milioni di coppie domanda–risposta. Ogni input diventa un vettore denso a 768 dimensioni, con pooling CLS e punteggio tramite prodotto scalare che definiscono questa esatta edizione.\n\n### Preparare una domanda e passaggi candidati\n\nScrivi la query come bisogno informativo e prepara le voci del corpus come passaggi testuali leggibili. Per esempio, una domanda sulla modifica di un indirizzo di consegna può essere confrontata con paragrafi separati su cambi di indirizzo, annullamento dell’ordine e tracciamento della consegna. Mantieni le condizioni pertinenti nel passaggio sul cambio di indirizzo, compreso il fatto che l’ordine sia già stato spedito o meno.\n\nCodifica query e passaggi con questo stesso modello. L’esempio pubblicato lo fa direttamente, senza un prefisso di query o documento, e ordina i passaggi secondo i punteggi del prodotto scalare. Mantieni ogni vettore collegato al passaggio originale e all’identificatore del documento, affinché il risultato ordinato possa mostrare il materiale effettivamente indicizzato.\n\n### Pooling CLS e l’edizione a prodotto scalare\n\nLa ricetta di riferimento del modello prende la rappresentazione del primo token, nota come pooling CLS. La sua tabella tecnica afferma esplicitamente che gli embedding non sono normalizzati e indica il prodotto scalare come funzione di punteggio adatta. Preserva quella ricetta quando imposti la raccolta e il lato delle query.\n\nLa normalizzazione L2 di questi vettori ne cambia la geometria dei punteggi. Il profilo normalizzato all-mpnet-base-v2 usa una ricetta diversa ed è un checkpoint separato, nonostante condivida la famiglia MPNet e un output a 768 componenti. Mantieni l’edizione esatta e la funzione di confronto insieme alla raccolta memorizzata, anziché sceglierle soltanto dalla lunghezza dei vettori.\n\n### Limite di lunghezza e passaggi più lunghi\n\nIl limite di input dichiarato è di 512 unità subword; il testo più lungo viene troncato. Il produttore osserva inoltre che gli input di addestramento raggiungevano soltanto 250 unità subword e che il testo più lungo può funzionare meno bene. La lunghezza accettata dal tokenizer e l’avvertenza sulla lunghezza di addestramento descrivono quindi confini pratici differenti.\n\nPer un articolo di aiuto esteso, prepara sezioni brevi che rispondano a domande specifiche. Conserva un titolo quando identifica l’argomento e mantieni una regola con l’eccezione necessaria per leggerla correttamente. Un unico input di pagina intera può perdere materiale successivo per troncamento, mentre un frammento troppo piccolo può perdere la condizione che lo rende utile.\n\n### Usare l’ordinamento nel recupero e nel RAG\n\nI vettori densi supportano una prima fase di recupero. Restituisci i passaggi candidati con i punteggi più alti insieme ai riferimenti alle fonti, quindi esamina se affrontano la domanda effettiva. In un flusso RAG, fornisci quei passaggi come materiale di origine alla fase di scrittura della risposta; il recupero stesso non compone la risposta.\n\nUsa domande rappresentative con passaggi pertinenti noti per scegliere il numero di risultati e valutare l’ordinamento. Includi esempi con vocabolario simile ma intento diverso, come modificare un indirizzo rispetto a visualizzare quello attuale. Interpreta i punteggi relativamente ai candidati sotto lo stesso modello e la stessa configurazione di punteggio, anziché come probabilità calibrate di correttezza.\n\nL’output utile di questo checkpoint è uno spazio di embedding per domande e passaggi destinato alla ricerca semantica. Vettori non normalizzati, pooling CLS, punteggio a prodotto scalare e l’avvertenza pubblicata sugli input lunghi sono i dettagli da preservare quando si preparano e si usano i risultati.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "2cac36ae4d60c514b0efa5536af294057f1a06461e0c5d5c56352875da193815", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "it", "methods": [ { "html": "sentence-transformers/multi-qa-mpnet-base-dot-v1Sentence Transformers multi-qa-mpnet-base-dot-v1 codifica domande e passaggi in vettori a 768 dimensioni per la ricerca semantica. Usa pooling CLS ed embedding non normalizzati progettati per punteggi tramite prodotto scalare, con un limite di input di 512 unità subword.
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.
multi-qa-mpnet-base-dot-v1 è un modello di Sentence Transformers progettato per recuperare passaggi testuali per una domanda o una query. Il suo addestramento ha usato circa 215 milioni di coppie domanda–risposta. Ogni input diventa un vettore denso a 768 dimensioni, con pooling CLS e punteggio tramite prodotto scalare che definiscono questa esatta edizione.
Scrivi la query come bisogno informativo e prepara le voci del corpus come passaggi testuali leggibili. Per esempio, una domanda sulla modifica di un indirizzo di consegna può essere confrontata con paragrafi separati su cambi di indirizzo, annullamento dell’ordine e tracciamento della consegna. Mantieni le condizioni pertinenti nel passaggio sul cambio di indirizzo, compreso il fatto che l’ordine sia già stato spedito o meno.
Codifica query e passaggi con questo stesso modello. L’esempio pubblicato lo fa direttamente, senza un prefisso di query o documento, e ordina i passaggi secondo i punteggi del prodotto scalare. Mantieni ogni vettore collegato al passaggio originale e all’identificatore del documento, affinché il risultato ordinato possa mostrare il materiale effettivamente indicizzato.
La ricetta di riferimento del modello prende la rappresentazione del primo token, nota come pooling CLS. La sua tabella tecnica afferma esplicitamente che gli embedding non sono normalizzati e indica il prodotto scalare come funzione di punteggio adatta. Preserva quella ricetta quando imposti la raccolta e il lato delle query.
La normalizzazione L2 di questi vettori ne cambia la geometria dei punteggi. Il profilo normalizzato all-mpnet-base-v2 usa una ricetta diversa ed è un checkpoint separato, nonostante condivida la famiglia MPNet e un output a 768 componenti. Mantieni l’edizione esatta e la funzione di confronto insieme alla raccolta memorizzata, anziché sceglierle soltanto dalla lunghezza dei vettori.
Il limite di input dichiarato è di 512 unità subword; il testo più lungo viene troncato. Il produttore osserva inoltre che gli input di addestramento raggiungevano soltanto 250 unità subword e che il testo più lungo può funzionare meno bene. La lunghezza accettata dal tokenizer e l’avvertenza sulla lunghezza di addestramento descrivono quindi confini pratici differenti.
Per un articolo di aiuto esteso, prepara sezioni brevi che rispondano a domande specifiche. Conserva un titolo quando identifica l’argomento e mantieni una regola con l’eccezione necessaria per leggerla correttamente. Un unico input di pagina intera può perdere materiale successivo per troncamento, mentre un frammento troppo piccolo può perdere la condizione che lo rende utile.
I vettori densi supportano una prima fase di recupero. Restituisci i passaggi candidati con i punteggi più alti insieme ai riferimenti alle fonti, quindi esamina se affrontano la domanda effettiva. In un flusso RAG, fornisci quei passaggi come materiale di origine alla fase di scrittura della risposta; il recupero stesso non compone la risposta.
Usa domande rappresentative con passaggi pertinenti noti per scegliere il numero di risultati e valutare l’ordinamento. Includi esempi con vocabolario simile ma intento diverso, come modificare un indirizzo rispetto a visualizzare quello attuale. Interpreta i punteggi relativamente ai candidati sotto lo stesso modello e la stessa configurazione di punteggio, anziché come probabilità calibrate di correttezza.
L’output utile di questo checkpoint è uno spazio di embedding per domande e passaggi destinato alla ricerca semantica. Vettori non normalizzati, pooling CLS, punteggio a prodotto scalare e l’avvertenza pubblicata sugli input lunghi sono i dettagli da preservare quando si preparano e si usano i risultati.
POST /v1/embeddingstext, token_idsembedding| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti sentence-transformers/multi-qa-mpnet-base-dot-v1 | Predefinito— |
Campoinput | Tipostring|string[]|integer[]|integer[][] | RequisitoObbligatorio | Valori e limiti Numero minimo di elementi: 1 Condizioni: Batch omogeneo non vuoto. Gli ID dei token sono numeri interi non negativi. Budget di input: Massimo: 512 · Unità di testo: byte UTF8 · Unità di token: elementi dell’array di token | Predefinito— |
Campoencoding_format | Tipostring | RequisitoFacoltativo | Valori e limiti float | Predefinitofloat |
Campodimensions | Tipointeger | RequisitoNon supportato | Valori e limiti Minimo: 1 | Predefinito— |
Campouser | Tipojson_value | RequisitoFacoltativo | Valori e limiti Condizioni: La fonte consente questo campo di metadati JSON; la semantica esatta del fornitore a monte dipende dal modello. | Predefinito— |
Camposession_id | Tipojson_value | RequisitoFacoltativo | Valori e limiti Condizioni: La fonte consente questo campo di metadati JSON; la semantica esatta del fornitore a monte dipende dal modello. | Predefinito— |
Campotrace | Tipojson_value | RequisitoFacoltativo | Valori e limiti Condizioni: La fonte consente questo campo di metadati JSON; la semantica esatta del fornitore a monte dipende dal modello. | Predefinito— |
Campoprovider | Tipoobject | RequisitoFacoltativo | Valori e limiti Condizioni: provider.options rifiutato | Predefinito— |
text_to_embedding
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, input |
Parametroinput_shapes | Contrattostring, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
Parametroencoding_format | Contrattofloat |
Parametrodimensions_override | Contrattofalse |
Parametromax_input_budget_units | Contratto512 |
Parametromultimodal_objects | Contrattofalse |
Parametromaterial_types | Contrattotext, token_ids |
Ciclo di vita: synchronous_json
Conserva l'indice e la dimensione di ogni vettore.
Il nome del modello multimodale non consente oggetti immagine su questo percorso specifico.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
| Configurazione | Listino delle tariffe | Costo |
|---|---|---|
| ConfigurazioneTariffe di base dei token | Listino delle tariffeTariffa base | Costo Input · Token in input $0.00001 / 1K token Output · Token in output $0 / 1K token Input · Lettura dalla cache — / 1K token Input · Scrittura nella cache — / 1K token Input · Scrittura nella cache, 1 ora — / 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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "sentence-transformers/multi-qa-mpnet-base-dot-v1", "input": ["First document", "Second document"]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.embeddings.create(model='sentence-transformers/multi-qa-mpnet-base-dot-v1',input=["First document","Second document"])\nprint(result)\nfor item in result.data:print(item.index,item.embedding)\njson
Conserva ogni risposta, file e parte di contenuto restituiti per intero.
Conserva ogni vettore con il suo indice. Il numero di vettori deve coincidere con il numero di input; le dimensioni devono essere coerenti.
Non viene introdotto alcun endpoint per i job di embedding.
| Campo | Tipo |
|---|---|
Campoobject | Tipostring |
Campomodel | Tipostring |
Campodata[].index | Tipointeger |
Campodata[].embedding | Tipofinite float[] |
Campousage | Tipoobject |
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampi obbligatori, rappresentazione del materiale o valore del parametro non validi | Passaggio successivoCorreggi i campi indicati prima di una nuova richiesta di creazione. |
Ailoot Ultra sentence-transformers/multi-qa-mpnet-base-dot-v1
Usa i percorsi dei metodi indicati sopra.