Richieste HTTP (curl)

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

Guida completa

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

export AILOOT_API_KEY="sk-..."

OpenAI Chat Completions

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."}
    ]
  }'

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

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"}]}'

OpenAI Responses

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"}'

Anthropic Messages

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?"}]
  }'

Gemini

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."}]}
    ]
  }'

Elenco dei modelli

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

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.

Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.Contatta l’assistenza