Guida rapida — API di intelligenza artificiale: chiave e prima richiesta
MarkdownLa 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.
| Metodo | Quando è adatto |
|---|---|
| Richiesta HTTP | Qualsiasi linguaggio, senza dipendenze, verifica rapida della chiave |
| OpenAI SDK | Python e Node.js; qualsiasi modello del catalogo nel formato OpenAI |
| Anthropic SDK | Claude e altri modelli nel formato Messages |
| Applicazioni pronte | 85 agenti, editor e chat: 77 con configurazione pronta, altri 8 in verifica |
Ottieni una chiave API per l’intelligenza artificiale
- Registrati
Crea un account su ailoot.ai/register. Poi accedi tramite ailoot.ai/login.
- Ricarica il saldo
Nell’area personale apri «Tariffe»: ricarica singola da $18 oppure abbonamento con bonus sul saldo. Approfondimenti: ricarica e abbonamenti.
- 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.
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 300Invia 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."}
]
}' 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)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);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.
{
"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)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 ?? "");
}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"}]}' 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 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 |
Cosa fare dopo
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.
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.