documentazione
IntroduzioneGuida rapida
Introduzione

Guida rapida — API di intelligenza artificiale: chiave e prima richiesta

Markdown

La prima risposta di un modello tramite Ailoot in un paio di minuti: chiave, indirizzo e una richiesta.

Guida completa

Ailoot è un’API unica per modelli di IA di diverse aziende: OpenAI, Anthropic, Google, xAI, DeepSeek, Alibaba, Moonshot, Z.ai, MiniMax, NVIDIA, Meta, Poolside e TypeSafe. Una chiave, un saldo in dollari. Il catalogo contiene 1256 schede modello e 2692 metodi documentati. Gli identificatori alternativi di chiamata o gli alias sono elencati nel metodo selezionato, quando disponibili.

Ailoot usa tre formati API: OpenAI, Anthropic e Gemini. Sono quindi adatti gli SDK pronti e quasi tutte le applicazioni che permettono un indirizzo API personalizzato: Claude Code, Codex CLI, Cline, Cursor, Open WebUI, n8n e decine di altre.

MetodoQuando è adatto
Richiesta HTTPQualsiasi linguaggio, senza dipendenze, verifica rapida della chiave
OpenAI SDKPython e Node.js; qualsiasi modello del catalogo nel formato OpenAI
Anthropic SDKClaude e altri modelli nel formato Messages
Applicazioni pronte85 agenti, editor e chat: 77 con configurazione pronta, altri 8 in verifica

Ottieni una chiave API per l’intelligenza artificiale

Ottieni una chiave

  1. Registrati

    Crea un account su ailoot.ai/register. Poi accedi tramite ailoot.ai/login.

  2. Ricarica il saldo

    Nell’area personale apri «Tariffe»: ricarica singola da $18 oppure abbonamento con bonus sul saldo. Approfondimenti: ricarica e abbonamenti.

  3. Crea una chiave API

    Nell’area personale apri la sezione delle chiavi e creane una nuova. La chiave inizia con sk-. Puoi copiarla nella sezione delle chiavi dell’area personale; conservala come una password.

Salva la chiave in una variabile d’ambiente
export AILOOT_API_KEY="sk-..."
# verifica: deve essere restituito l'elenco dei modelli
curl -s https://api.ailoot.ai/v1/models -H "Authorization: Bearer $AILOOT_API_KEY" | head -c 300

Invia la prima richiesta

L’indirizzo API è https://api.ailoot.ai. Per gli SDK nel formato OpenAI l’indirizzo di base è https://api.ailoot.ai/v1, per Anthropic e Gemini è https://api.ailoot.ai senza suffisso: questi SDK aggiungono il percorso da soli.

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

La risposta arriva nel formato consueto. Il blocco usage indica quanti token sono stati usati per domanda e risposta: su questi viene calcolato l’addebito.

200 OK
{
  "id": "chatcmpl-8f2c…",
  "object": "chat.completion",
  "created": 1790812800,
  "model": "claude-sonnet-5-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Un’API è un accordo su come un programma chiede a un altro di fare qualcosa…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 21,
    "completion_tokens": 48,
    "total_tokens": 69
  }
}

Risposta in streaming

Con "stream": true la risposta arriva nel formato Server-Sent Events, come nelle API originali, quindi SDK e client la interpretano senza modifiche. In OpenAI SDK è comodo richiedere il valore finale di usage nell’ultimo evento.

stream = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "Scrivi un haiku sulla pioggia"}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Scegli un modello

Il campo model — identificatore esatto dal catalogo dei modelli oppure dalla risposta GET /v1/models. Molti modelli hanno alias brevi, ad esempio claude-sonnet-latest oppure qwen. Nel catalogo puoi vedere a quale modello punta l’alias attualmente; per risultati riproducibili usa l’ID esatto.

AttivitàDa dove iniziare
Codice e agenticlaude-sonnet-5-5, gpt-6.1-sol, claude-opus-5-5
Veloce ed economicogemini-3.8-flash, deepseek-v4.1-flash, qwen3.8-flash
Contesto lungo fino a 1M tokenclaude-sonnet-5-5, deepseek-v4-pro, qwen3.8-max
Immaginigpt-image-2.5, gemini-3.1-flash-image, grok-imagine-image-2.0

Cosa fare dopo

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

API di intelligenza artificiale: chiave e prima richiesta

Dove creo la chiave per le API di intelligenza artificiale?

Nell’area personale apri la sezione delle chiavi e creane una nuova. La chiave inizia con sk-. Puoi copiarla nella sezione delle chiavi dell’area personale; conservala come una password.

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento
Scegli un piano scontato per richieste regolari.
Codice fino al 50%
Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.
Spese nella cronologia
Modello, token e importo sono salvati per ogni richiesta.

Scegli abbonamento · Consulta prezzi dei modelli

Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale
Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.
Licenza reseller
Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.
Documenti sul sito
Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

Richiedi licenza reseller · Offerta e accordo di licenza

Domande

Come invio la mia prima richiesta API?

Crea una chiave API Ailoot. Imposta https://api.ailoot.ai/v1 per l'SDK OpenAI, oppure https://api.ailoot.ai per gli SDK Anthropic e Gemini. GET /v1/models è gratuito ed elenca i modelli disponibili per la tua chiave; poi usa l'esempio per il modello e il metodo API selezionati.

Quale chiave API devo usare?

Usa una chiave API Ailoot del tuo account nel campo di autenticazione del formato client selezionato. Invia GET /v1/models con la stessa chiave per verificarne gratuitamente l'accesso ai modelli; una chiave di un altro servizio non dà accesso ad Ailoot.

Cosa devo controllare se la prima richiesta non va a buon fine?

Verifica che l'indirizzo API, la chiave API Ailoot, l'ID esatto del modello e il metodo API corrispondano alla scheda del modello e all'esempio di richiesta. Leggi l'errore restituito; se hai bisogno di aiuto, invia l'errore e l'ID della richiesta a support@ailoot.ai senza includere la tua chiave API.

Cosa offre l’abbonamento?

Sconto sull’acquisto di token per lavoro regolare. Scegli piano per volume; condizioni e prezzo sono mostrati alla sottoscrizione.

Come applico un codice fino al 50%?

Inseriscilo acquistando token. Il totale segue la promozione e lo sconto è visibile prima del pagamento.