Embedding in blocco
La versione in blocco calcola gli embedding di tante frasi o documenti in un colpo solo, invece di uno per volta. Dai in pasto una lista — righe di un CSV, schede di prodotto, domande frequenti — e ottieni tutti i vettori pronti da caricare in un indice di ricerca. Stesso modello, molte meno chiamate.
Esegui online
Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.
Quando conviene lavorare in blocco
Se hai un solo testo, la versione singola basta. Ma quando devi vettorizzare un catalogo intero, l’archivio delle circolari o migliaia di recensioni, farlo una riga alla volta è lento e scomodo. In blocco passi l’elenco completo e ricevi i vettori nello stesso ordine, pronti da collegare a ogni voce di partenza. È il passo tipico prima di costruire un indice: prima vettorizzi tutto, poi cerchi.
Limiti e come dividere il lavoro
Ogni esecuzione accetta fino a 10.000 blocchi e 20.000 token complessivi. Se la tua lista è più lunga, la spezzi in più invii: il risultato è identico a farla tutta insieme. Consiglio pratico: tieni ogni blocco su un singolo concetto — una scheda, un paragrafo, una FAQ — perché un vettore che mescola argomenti diversi cerca peggio. Testi troppo lunghi vanno tagliati prima.
Web, API e integrazione
Puoi incollare la lista dalla pagina del KIT o inviarla via API quando l’operazione fa parte di un flusso automatico, per esempio a ogni aggiornamento del catalogo; a breve anche da altri canali. L’output è pensato per essere ricaricato subito nell’indice, senza passaggi manuali.
Quanto costa un lotto
La tariffa è la stessa della versione singola: $0.002 a richiesta più $0.0015 ogni 1.000 token, in dollari. Il vantaggio del blocco è operativo, non un sovrapprezzo. Un catalogo di mille schede brevi costa in genere pochi centesimi. Il totale dipende dai token, non dal numero di righe: righe corte, spesa minima.
Casi d'uso
Migrazione del catalogo di Tecnoedil Verona
Tecnoedil Verona S.n.c. vettorizza in un’unica notte le 3.000 schede del listino per abilitare la ricerca per significato sul sito, invece del vecchio filtro per codice articolo.
Archivio di recensioni
Un negozio online passa in blocco tutte le recensioni raccolte per poi raggrupparle e capire di cosa parlano davvero i clienti.
FAQ di un help desk
Un servizio clienti vettorizza in una volta l’intero archivio di domande e risposte, così un bot potrà trovare quella pertinente a ogni nuovo messaggio.
Domande frequenti
L’ordine dei risultati corrisponde a quello della lista?
Sì. I vettori tornano nello stesso ordine dei testi inviati, così colleghi ogni embedding alla sua riga senza confusione.
Quanti elementi posso mandare per volta?
Fino a 10.000 blocchi e 20.000 token per esecuzione. Per liste più grandi basta dividerle in più invii successivi.
Costa meno che farli uno a uno?
Il prezzo per token è identico: $0.0015 ogni 1.000 token più $0.002 a richiesta. In blocco risparmi tempo e chiamate, non il costo del calcolo.
Che fine fanno i testi inviati?
Vengono elaborati per produrre i vettori e poi eliminati. Non restano sui nostri server e non alimentano l’addestramento di alcun modello.
Posso automatizzarlo a ogni aggiornamento del catalogo?
Sì, via API: colleghi l’operazione al tuo gestionale e i nuovi articoli vengono vettorizzati appena inseriti.
Il supporto risponde in italiano?
Ti risponde una persona vera, in inglese o spagnolo. Scrivici pure in italiano: ci capiamo e non ti lasciamo a un bot.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/search/embed-batch \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/search/embed-batch", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/search/embed-batch",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/embed-batch", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/embed-batch", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"text": "…"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.embed_batch",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_chunks | 10000 |
max_tokens | 20000 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |