Source: https://ailoot.ai/docs/it/ Canonical: https://ailoot.ai/docs/it/ Language: it [Introduzione](https://ailoot.ai/docs/it/) # Guida rapida — API di intelligenza artificiale: chiave e prima richiesta [Markdown](https://ailoot.ai/docs/it/index.md) La prima risposta di un modello tramite Ailoot in un paio di minuti: chiave, indirizzo e una richiesta. 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. | Metodo | Quando è adatto | | --- | --- | | [Richiesta HTTP](https://ailoot.ai/docs/it/connect/curl/) | Qualsiasi linguaggio, senza dipendenze, verifica rapida della chiave | | [OpenAI SDK](https://ailoot.ai/docs/it/connect/openai-sdk/) | Python e Node.js; qualsiasi modello del catalogo nel formato OpenAI | | [Anthropic SDK](https://ailoot.ai/docs/it/connect/anthropic-sdk/) | Claude e altri modelli nel formato Messages | | [Applicazioni pronte](https://ailoot.ai/integrations/it/) | 85 agenti, editor e chat: 77 con configurazione pronta, altri 8 in verifica | Ti serve un programma specifico? Apri il [catalogo delle integrazioni](https://ailoot.ai/integrations/it/): per ciascuno trovi dove inserire indirizzo e chiave e un config pronto da copiare. ## Ottieni una chiave API per l’intelligenza artificiale [](https://ailoot.ai/docs/it/#key)Ottieni una chiave 1. **Registrati** Crea un account su [ailoot.ai/register](https://ailoot.ai/register). Poi accedi tramite [ailoot.ai/login](https://ailoot.ai/login). 2. **Ricarica il saldo** Nell’area personale apri «Tariffe»: ricarica singola da $18 oppure abbonamento con bonus sul saldo. Approfondimenti: [ricarica](https://ailoot.ai/docs/it/billing/topup/) e [abbonamenti](https://ailoot.ai/docs/it/billing/subscriptions/). 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 ```bash 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 ``` ## [](https://ailoot.ai/docs/it/#first-request)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. ```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."} ] }' ``` ```python from openai import OpenAI import os client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"], ) resp = client.chat.completions.create( model="claude-sonnet-5-5", messages=[{"role": "user", "content": "Spiega in due frasi che cos’è un’API."}], ) print(resp.choices[0].message.content) ``` ```js import OpenAI from "openai"; const client = new OpenAI({ maxRetries: 0, baseURL: "https://api.ailoot.ai/v1", apiKey: process.env.AILOOT_API_KEY, }); const resp = await client.chat.completions.create({ model: "claude-sonnet-5-5", messages: [{ role: "user", content: "Spiega in due frasi che cos’è un’API." }], }); console.log(resp.choices[0].message.content); ``` ```python import anthropic import os client = anthropic.Anthropic(max_retries=0, base_url="https://api.ailoot.ai", # senza /v1: l'SDK aggiunge autonomamente /v1/messages api_key=os.environ["AILOOT_API_KEY"], ) msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Spiega in due frasi che cos’è un’API."}], ) print(msg.content[0].text) ``` 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 ```json { "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 } } ``` ## [](https://ailoot.ai/docs/it/#streaming)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. 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. ```python 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) ``` ```js const stream = await 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 await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ""); } ``` ```bash curl -N https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6.1-sol", "stream": true, "messages": [{"role": "user", "content": "Scrivi un haiku sulla pioggia"}]}' ``` ## [](https://ailoot.ai/docs/it/#models)Scegli un modello Il campo `model` — identificatore esatto dal [catalogo dei modelli](https://ailoot.ai/models/it/) 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 agenti | `claude-sonnet-5-5`, `gpt-6.1-sol`, `claude-opus-5-5` | | Veloce ed economico | `gemini-3.8-flash`, `deepseek-v4.1-flash`, `qwen3.8-flash` | | Contesto lungo fino a 1M token | `claude-sonnet-5-5`, `deepseek-v4-pro`, `qwen3.8-max` | | Immagini | `gpt-image-2.5`, `gemini-3.1-flash-image`, `grok-imagine-image-2.0` | Non tutti i modelli sono disponibili in tutti i formati. Ad esempio, i modelli Gemini funzionano tramite Anthropic Messages e il formato nativo Gemini, mentre tramite OpenAI Chat solo `gemini-3.6-flash`. I formati disponibili per un modello sono visibili nel [catalogo](https://ailoot.ai/models/it/). ## [](https://ailoot.ai/docs/it/#next)Cosa fare dopo [**Come funziona** Il ciclo della richiesta, riserva e addebito, errori](https://ailoot.ai/docs/it/how-it-works/) [**Compatibilità** Formati e client supportati](https://ailoot.ai/docs/it/compatibility/) [**Integrazioni** 77 applicazioni con configurazione pronta](https://ailoot.ai/integrations/it/) [**Errori e limiti** Codici di risposta e come gestirli](https://ailoot.ai/docs/it/errors/) Hai altre domande? Invia il Request ID e una descrizione — ti aiuteremo a chiarire il problema.[Contatta l’assistenza](mailto:support@ailoot.ai) ## 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](https://ailoot.ai/docs/it/billing/subscriptions/) · [Consulta prezzi dei modelli](https://ailoot.ai/models/it/) ## 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](mailto:support@ailoot.ai) · [Offerta e accordo di licenza](https://ailoot.ai/legal/offer?lang=it) ## 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. ## 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.