Riferimento API
Embedding
Nessun modello lo supporta ancora
Al momento nessun modello del catalogo supporta questa route. La pagina resta come riferimento.
POST
/v1/embeddingsEmbedding vettoriali in formato OpenAI — text-embedding-3, jina-embeddings, voyage ed equivalenti di altri fornitori. Fatturazione in base ai token di input.
#Parametri della richiesta
modelstringobbligatorioUn ID di modello di embedding, per esempio text-embedding-3-small.
inputstring | arrayobbligatorioUna stringa o un array — la risposta restituisce i vettori nello stesso ordine.
dimensionsintegerfacoltativoTronca il vettore sui modelli che supportano le dimensioni Matryoshka.
encoding_formatstringfacoltativo"float" (predefinito) o "base64" per un payload compatto.
#Errori correlati
- 400 invalid_request_errorCorpo malformato o parametro non supportato per 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/embeddings \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "text-embedding-3-small",
"input": ["hello world", "another sentence"]
}'#Risposta
response.json
{
"object": "list",
"model": "text-embedding-3-small",
"data": [
{"object": "embedding", "index": 0, "embedding": [0.0023, -0.0091, …]},
{"object": "embedding", "index": 1, "embedding": [0.0154, 0.0007, …]}
],
"usage": {"prompt_tokens": 8, "total_tokens": 8}
}Non hai ancora risolto?
Inviaci l'ID richiesta o il messaggio di errore e verificheremo.