Source: https://ailoot.ai/docs/it/connect/curl/
Canonical: https://ailoot.ai/docs/it/connect/curl/
Language: it

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

# Richieste HTTP (curl)

[Markdown](https://ailoot.ai/docs/it/connect/curl/index.md)

Uso dell’API senza SDK: qualsiasi linguaggio o strumento in grado di inviare una richiesta HTTP.

Tutte le richieste vanno a `https://api.ailoot.ai` tramite HTTPS, con corpo JSON (multipart per il caricamento di file). La chiave è in uno degli header di autorizzazione.

Chiave in una variabile

```bash
export AILOOT_API_KEY="sk-..."
```

## [](https://ailoot.ai/docs/it/connect/curl/#chat)OpenAI Chat Completions

```bash
curl https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [
      {"role": "user", "content": "Spiega in due frasi che cos’è un’API."}
    ]
  }' 
```

## [](https://ailoot.ai/docs/it/connect/curl/#stream)Risposta in streaming

Il flag `-N` disabilita il buffering di curl, così gli eventi vengono mostrati appena arrivano. Ogni evento inizia con `data:`, il flusso termina con la riga `data: [DONE]`.

Ailoot restituisce la risposta testuale a pagamento dopo il calcolo del costo. Quindi con `stream: true` il formato resta in streaming (SSE), ma il testo arriva in un unico blocco quando il modello termina, non parola per parola. Se la risposta richiede più di circa 15 secondi, nei flussi Chat Completions, Responses e Messages arrivano prima le righe di servizio `: ping` (circa ogni 10 secondi), poi la riga `: ailoot-charged-usd …` con l’importo addebitato e i dati. Gli SDK ignorano queste righe.

```bash
curl -N https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4-pro", "stream": true,
       "messages": [{"role": "user", "content": "Conta fino a cinque"}]}' 
```

## [](https://ailoot.ai/docs/it/connect/curl/#responses)OpenAI Responses

```bash
curl https://api.ailoot.ai/v1/responses \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6.1-sol", "input": "Formula un brindisi per il compleanno di un collega"}' 
```

## [](https://ailoot.ai/docs/it/connect/curl/#messages)Anthropic Messages

```bash
curl https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Ciao! Che cosa sai fare?"}]
  }' 
```

## [](https://ailoot.ai/docs/it/connect/curl/#gemini)Gemini

```bash
curl "https://api.ailoot.ai/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "Proponi tre nomi per una caffetteria."}]}
    ]
  }' 
```

## [](https://ailoot.ai/docs/it/connect/curl/#models)Elenco dei modelli

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY" | jq -r '.data[].id'
```

## [](https://ailoot.ai/docs/it/connect/curl/#headers)Header della risposta

Aggiungi `-i` per vedere gli header. `X-Request-ID` — identificatore della richiesta: compare anche nel testo degli errori. `X-Ailoot-Charged-USD` — importo addebitato per la risposta testuale a pagamento. Tutti gli header sono nella pagina [Come funziona](https://ailoot.ai/docs/it/how-it-works/#headers).

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.