Source: https://ailoot.ai/docs/it/api/embeddings/
Canonical: https://ailoot.ai/docs/it/api/embeddings/
Language: it

[API](https://ailoot.ai/docs/it/) 

# Embeddings

[Markdown](https://ailoot.ai/docs/it/api/embeddings/index.md)

Rappresentazioni vettoriali del testo per ricerca, RAG e clustering.

POST`https://api.ailoot.ai/v1/embeddings`

Embeddings

```bash
curl https://api.ailoot.ai/v1/embeddings \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "nvidia/nemotron-3-embed-1b", "input": ["Primo documento", "Secondo documento"]}' 
```

```python
emb = client.embeddings.create(
    model="nvidia/nemotron-3-embed-1b",
    input=["Primo documento", "Secondo documento"],
)
vectors = [d.embedding for d in emb.data]
```

200 OK

```json
{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0123, -0.0456, 0.0789, …] },
    { "object": "embedding", "index": 1, "embedding": [-0.0321, 0.0654, 0.0987, …] }
  ],
  "model": "nvidia/nemotron-3-embed-1b",
  "usage": { "prompt_tokens": 8, "total_tokens": 8 }
}
```

## Autorizzazione

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `Authorization` | header | obbligatorio | Chiave nel formato `Bearer sk-…`. Sono accettati anche gli header `x-api-key` oppure `x-goog-api-key`. |

## Corpo della richiesta

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `model` | string | obbligatorio | Modello di embedding: `nvidia/nemotron-3-embed-1b`, `nvidia/llama-nemotron-embed-vl-1b-v2`. |
| `input` | string \| array | obbligatorio | Stringa o array di stringhe. La lunghezza di ogni input è limitata dal contesto del modello (4096 token per i modelli NVIDIA). |
| `encoding_format` | string | facoltativo | `float` (predefinito) oppure `base64` — se il modello lo supporta. |

## Risposta

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `data[].embedding` | array |  | Vettore di numeri per ciascun input, nello stesso ordine. |
| `usage` | object |  | Numero di token di input. L’output degli embedding non viene addebitato. |

Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.[Contatta l’assistenza](mailto:support@ailoot.ai)

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