Collega Ailoot ai tuoi strumenti preferiti — Chiamate API per intelligenza artificiale nei client
Agenti, editor, chat e SDK che accettano la chiave Ailoot. Il pulsante «Configura» mostra dove inserire indirizzo e chiave e un config pronto da copiare.
Categoria · Formato API
Tutte le integrazioni
Statistiche
85applicazioni
77pronte
8in verifica
Agenti nel terminale
Agenti di coding e CLI: scrivono codice, eseguono comandi e modificano file.
Variabili d’ambiente o blocco "env" in ~/.claude/settings.json (per un progetto — .claude/settings.local.json); estensione VS Code — claudeCode.environmentVariables; verifica — comando /status
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
export AILOOT_API_KEY="sk-..."
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"
claude
Modello di esempio: claude-sonnet-5-5
Importante
Indirizzo senza /v1: Claude Code aggiunge da solo /v1/messages. ANTHROPIC_AUTH_TOKEN viene inviato come Authorization: Bearer, ANTHROPIC_API_KEY come x-api-key; Ailoot accetta entrambi. CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 inserisce i nostri modelli in /model tramite /v1/models. Per gli errori 400 su campi sconosciuti — CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1. La documentazione Anthropic non supporta Claude Code con modelli non Claude tramite gateway, anche se il nostro /v1/messages li gestisce; consigliamo modelli Claude. Remote Control e input vocale non sono disponibili con il gateway.
~/.codex/config.toml (solo file utente: nel .codex/config.toml del progetto model_provider/model_providers vengono ignorati); chiave nella variabile indicata in env_key
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "ailoot"
[model_providers.ailoot]
name = "Ailoot"
base_url = "https://api.ailoot.ai/v1"
env_key = "AILOOT_API_KEY"
wire_api = "responses"
export AILOOT_API_KEY="sk-..."
codex
Modello di esempio: gpt-6.1-sol
Importante
Codex funziona solo tramite OpenAI Responses API (la documentazione indica solo wire_api = "responses"), quindi serve il nostro /v1/responses. Gli ID provider openai, ollama, lmstudio sono riservati. Alternativa — openai_base_url = "https://api.ailoot.ai/v1" per il provider integrato openai. Ailoot fornisce a Codex l’elenco nel formato manifesto Codex (GET /v1/models con client_version). Scegli un modello specifico che abbia OpenAI Responses nel catalogo. Nello snapshot 2026-09-30 gemini-3.6-flash ha OpenAI Chat, Anthropic Messages e Gemini, ma non Responses, quindi non è adatto a Codex. Verifica i formati sulla scheda del modello, non dal nome della famiglia.
hermes model → «Custom endpoint (self-hosted / VLLM / etc.)» oppure ~/.hermes/config.yaml (sezione model o dizionario providers)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5
Importante
transport: chat_completions (OpenAI Chat), anthropic_messages (Anthropic Messages) o codex_responses (OpenAI Responses). LLM_MODEL in .env non è più usato; OPENAI_BASE_URL vale solo per il provider openai-api. Per anthropic_messages indica l’indirizzo senza /v1 — Anthropic SDK aggiunge da solo /v1/messages. I compiti ausiliari (riconoscimento immagini, compressione della cronologia) usano per impostazione predefinita lo stesso modello principale.
Config OpenClaw (~/.openclaw/openclaw.json) → models.providers.<id>; modello predefinito — agents.defaults.model.primary; modifica sicura — openclaw config set models.providers.<id> '<json>' --strict-json --merge
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5
Importante
Adapter api: openai-completions (predefinito se baseUrl è impostato), openai-responses (solo se il server supporta /v1/responses — Ailoot lo supporta), anthropic-messages, google-generative-ai e altri. Per anthropic-messages negli esempi OpenClaw baseUrl è senza /v1. OpenClaw può trasmettere immagini quando input del modello contiene "image". Negli esempi Claude è mantenuto solo testo: lo snapshot 2026-09-30 non dichiara input image per questi metodi. Aggiungi "image" solo per un modello specifico la cui scheda attuale dichiari immagini in input e il formato API scelto. Ad esempio gemini-3.6-flash in questo snapshot dichiara input image per OpenAI Chat; il supporto effettivo dipende dalla scheda del modello e dal formato. Il percorso del file principale è basato sulla pratica comune OpenClaw; la pagina letta menziona anche ~/.openclaw/agents/<agentId>/agent/models.json.
opencode.json (nel progetto o ~/.config/opencode/opencode.json) → provider.<id>; chiave tramite /connect oppure "apiKey": "{env:VAR}"
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5
Importante
Il pacchetto @ai-sdk/openai-compatible usa /v1/chat/completions. Per modelli che richiedono /v1/responses, la documentazione opencode indica @ai-sdk/openai. Un provider Anthropic compatibile con baseURL personalizzato non è descritto nella documentazione opencode. Scegli modelli per cui il catalogo attuale dichiari OpenAI Chat. Nello snapshot 2026-09-30 gemini-3.6-flash ha questo formato; per altri Gemini controlla le schede. Il formato nativo Gemini non usa questo percorso. La presenza del metodo nel catalogo non equivale a una prova dal vivo della specifica versione del client.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: qwen3.8-max
Importante
Tipi di protocollo: openai (Chat Completions), anthropic, gemini, vertex-ai. Per openai baseUrl include /v1. L’esempio della documentazione per anthropic e gemini non ha baseUrl, quindi consigliamo openai. Per openai scegli un modello con OpenAI Chat nel catalogo: gemini-3.6-flash lo supporta. Altri Gemini possono avere formati diversi — controlla la scheda del modello specifico. La variante settings.json legge la chiave da AILOOT_API_KEY (campo envKey): impostala con export AILOOT_API_KEY=sk-... oppure la riga AILOOT_API_KEY=sk-... in ~/.qwen/.env; altrimenti Qwen Code parte con chiave vuota e riceve 401.
Variabili d’ambiente GEMINI_API_KEY e GOOGLE_GEMINI_BASE_URL; modalità di accesso — ~/.gemini/settings.json → security.auth.selectedType = "gemini-api-key"; modello — GEMINI_MODEL o flag -m
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Indirizzo senza /v1beta: l’SDK aggiunge automaticamente /v1beta/models/{model}:generateContent. L’indirizzo deve utilizzare HTTPS. La chiave viene inviata nell’header x-goog-api-key, che Ailoot accetta. Sono adatti solo i modelli per cui il catalogo indica il formato Gemini. Prima dell’esecuzione, verifica che l’ID esatto e questo metodo siano disponibili per la tua chiave. Ailoot restituisce la risposta Gemini a pagamento per intero dopo il calcolo del costo, non parola per parola; per questo, nelle risposte lunghe il testo non compare subito.
~/.kimi/config.toml (sezioni providers e models, default_model); /login supporta solo le piattaforme Moonshot — l’indirizzo personalizzato si imposta manualmente nel file
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Tipi: openai_legacy (Chat Completions, base_url con /v1), openai_responses (Responses, con /v1), anthropic (senza /v1), gemini (base_url è la radice Google, per noi https://api.ailoot.ai). SearchWeb funziona solo con la piattaforma propria di Moonshot; FetchURL con un altro indirizzo API passa al download locale.
crushrc (config Bash): ./.crushrc, ./crushrc oppure ~/.config/crush/crushrc; il vecchio formato crush.json è obsoleto, ma funziona
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: deepseek-v4-pro
Importante
Il tipo openai-compat usa OpenAI Chat con indirizzo che include /v1. Il tipo anthropic usa Messages con indirizzo senza /v1: Crush lo passa ad anthropic-sdk-go, che aggiunge da solo /v1/messages. L’esempio nel README Crush con /v1 produrrebbe /v1/v1/messages e un errore 404. La chiave viene inviata nell’header x-api-key, accettato da Ailoot. Se l’elenco dei modelli è vuoto, il provider openai-compat lo recupera da /v1/models. crushrc viene eseguito come codice: non avviare Crush in cartelle altrui con questo file. Nell’esempio Claude ha supports-images = false: lo snapshot del catalogo 2026-09-30 dichiara solo testo per il formato Messages selezionato. Se la tua versione Crush supporta questo flag, attivalo solo per un modello la cui scheda attuale dichiari input image nel formato API scelto; il flag del client non aggiunge da solo il supporto delle immagini al modello.
Variabili OPENAI_API_BASE e OPENAI_API_KEY, flag --model openai/<modello>
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Il prefisso openai/ è obbligatorio: così Aider (tramite LiteLLM) invia richieste al percorso OpenAI compatibile /v1/chat/completions. Per i modelli sconosciuti ad Aider avvisa che il contesto è ignoto — non è un errore. Un indirizzo Anthropic con base URL personalizzato non è descritto in questa pagina di documentazione.
goose configure → Custom Providers → Add A Custom Provider, oppure JSON in ~/.config/goose/custom_providers/ (Windows: %APPDATA%\Block\goose\config\custom_providers\); alternativa — provider OpenAI integrato con OPENAI_HOST/OPENAI_BASE_PATH
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Motori del provider personalizzato: openai, anthropic, ollama. Nell’esempio Goose base_url per engine openai è il percorso completo fino a /v1/chat/completions. Per il provider integrato OPENAI_HOST è la radice senza percorso, OPENAI_BASE_PATH è il percorso (predefinito v1/chat/completions). Goose ignora la chiave in config.yaml — solo variabile o portachiavi. Il repository è stato trasferito a aaif-goose/goose.
~/.factory/settings.json → array customModels; selezione del modello — comando /model, sezione «Custom models»
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5
Importante
provider: anthropic = Messages API (baseUrl come Anthropic, senza /v1), openai = Responses API (con /v1), generic-chat-completion-api = Chat Completions (con /v1). Per anthropic la chiave viene inviata per impostazione predefinita in x-api-key (accettato da Ailoot); "authMode": "bearer" passa ad Authorization. Le chiavi restano locali. Factory testa completamente solo le API ufficiali Anthropic e OpenAI.
Impostazioni → Model Routing → Add → Custom URL (oppure Model Routing del workspace per il team); dal terminale — amp config model-providers (list, test, set-priority, edit-router…)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Model Routing → Add → Custom URL
Format: anthropic-messages
Base URL: https://api.ailoot.ai
API key: sk-...
Model mapping:
anthropic/claude-fable-5 -> anthropic/claude-fable-5
Seconda connessione per GPT:
Format: responses
Base URL: https://api.ailoot.ai/v1
API key: sk-...
Model mapping:
openai/gpt-5.6-sol -> gpt-5.6-sol
Verifica: amp config model-providers check-access --provider-model anthropic/claude-fable-5
Modello di esempio: claude-fable-5
Importante
Formati Custom URL: chat-completions (<base>/chat/completions), responses (<base>/responses), anthropic-messages (<base>/v1/messages, /v1 non viene duplicato), google-genai (<base>/models/<model>:streamGenerateContent). La chiave viene inviata come Authorization: Bearer. La mappatura usa gli ID canonici Amp nel formato provider/model; la freccia definisce l’ID inviato a noi. I modelli non coperti dalla connessione sono gestiti direttamente da Amp usando i suoi crediti. La documentazione richiede che l’host personalizzato sia raggiungibile da Amp — l’indirizzo è pubblico, quindi il requisito è soddisfatto.
config.yaml di AIChat → clients (tipi openai-compatible, claude, gemini); modello — -m <client>:<model>
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Nell’esempio di configurazione AIChat api_base per claude è indicato con /v1, per gemini con /v1beta; vale anche per Ailoot. I tre client danno accesso a tutti e tre i formati Ailoot: OpenAI, Anthropic e Gemini.
Config YAML di Continue (config.yaml), passato alla CLI con il flag --config <path>
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Per servizi OpenAI compatibili Continue usa provider: openai e apiBase con /v1. Il formato di configurazione è comune a estensione e CLI; il file si passa con --config.
forge provider login → OpenAI-compatible (percorso consigliato); percorso obsoleto — .env con OPENAI_URL e OPENAI_API_KEY più model in forge.yaml
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
# consigliato:
forge provider login # seleziona OpenAI-compatible e inserisci https://api.ailoot.ai/v1 e sk-...
# metodo obsoleto (.env):
OPENAI_API_KEY=sk-...
OPENAI_URL=https://api.ailoot.ai/v1
# forge.yaml
model: claude-sonnet-5-5
Modello di esempio: claude-sonnet-5-5
Importante
La configurazione tramite .env è indicata come obsoleta: al primo avvio Forge trasferisce le variabili nel proprio archivio su file. Il README non riporta le etichette esatte della procedura provider login.
Variabili d’ambiente COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY, COPILOT_MODEL (o flag --model)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Tipi: openai (predefinito, qualsiasi server OpenAI compatibile), azure, anthropic. Il modello deve supportare chiamate agli strumenti e streaming. COPILOT_PROVIDER_WIRE_API sceglie il protocollo, ma i suoi valori non sono elencati nella pagina. Puoi impostare i limiti con COPILOT_PROVIDER_MAX_PROMPT_TOKENS / MAX_OUTPUT_TOKENS.
~/.config/gptme/config.toml → [[providers]]; il modello si sceglie come <provider>/<model>
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Qualsiasi server OpenAI compatibile; la chiave viene cercata in api_key, poi api_key_env, poi <NAME>_API_KEY. Elenco dei provider — gptme-util providers list.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5
Importante
La finestra Custom provider permette di scegliere il protocollo: OpenAI Compatible (Chat Completions), OpenAI Responses, Anthropic Messages. {env:VAR} funziona solo nella configurazione globale attendibile (~/.config/kilo); nel kilo.json del progetto la chiave non viene inserita dalla variabile.
File extra-openai-models.yaml nella cartella delle impostazioni llm; chiave — llm keys set <nome>
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Per impostazione predefinita Chat Completions; responses: true porta il modello su /responses. Se api_base è impostato, la chiave OpenAI non viene inviata — serve api_key_name. È un’utilità CLI per richieste, non un agente.
Config YAML dell’agente → sezione model (model_name, model_kwargs); il percorso predefinito del config si modifica con MSWEA_MINI_CONFIG_PATH
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Usa LiteLLM: model_kwargs viene passato direttamente a litellm.completion. Senza il registro prezzi LiteLLM segnala un costo sconosciuto — disabilitiamo con cost_tracking: "ignore_errors" (oppure MSWEA_COST_TRACKING=ignore_errors). Trasmettere la chiave tramite OPENAI_API_KEY è uno standard LiteLLM, non mostrato nella pagina mini-SWE-agent.
Ctrl+P → Settings (provider e modello), file ~/.openhands/agent_settings.json (llm.model / llm.api_key / llm.base_url) oppure variabili LLM_MODEL, LLM_API_KEY, LLM_BASE_URL con --override-with-envs
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
export AILOOT_API_KEY="sk-..."
# una tantum tramite le variabili d'ambiente:
export LLM_MODEL=openai/claude-sonnet-5-5
export LLM_API_KEY="$AILOOT_API_KEY"
export LLM_BASE_URL=https://api.ailoot.ai/v1
openhands --override-with-envs
Modello di esempio: openai/claude-sonnet-5-5
Importante
OpenHands usa LiteLLM; per un proxy OpenAI la documentazione richiede Custom Model nel formato openai/<modello> e Base URL del proxy. Le modifiche tramite --override-with-envs non vengono salvate. Nell’interfaccia web: Settings → LLM → Advanced → Custom Model, Base URL, API Key.
~/.pi/agent/models.json (oppure .pi/models.json del progetto dopo averlo considerato attendibile); scelta — /model
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5
Importante
La documentazione Pi permette esplicitamente endpoint OpenAI, Anthropic e Google compatibili tramite models.json; l’esempio usa api: openai-completions. apiKey comprende $NAME/${NAME}, un valore letterale o !comando. Il file viene riletto quando si apre /model.
plandex models custom (oppure \models custom nel REPL) — apre il file JSON dei modelli e provider personalizzati
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5
Importante
I provider personalizzati funzionano solo in Plandex self-hosted; nel cloud con chiavi BYO sono ammessi solo provider integrati. Tutti i provider personalizzati devono essere OpenAI compatibili (Chat Completions). Il modello viene poi attivato nel proprio model pack.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
In YAML usa solo spazi, niente tabulazioni. Per Anthropic — provider: anthropic e ANTHROPIC_BASE_URL (il README non specifica esattamente se anthropic richiede /v1; usa https://api.ailoot.ai).
Settings → cerca «inference endpoint» → Custom inference endpoint: URL di base, chiave, ID dei modelli; poi scegli il modello nel selettore
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Settings → inference endpoint
Endpoint URL: https://api.ailoot.ai/v1
API key: sk-...
Models: claude-sonnet-5-5, gpt-6.1-sol, deepseek-v4-pro
Poi seleziona, per esempio, claude-sonnet-5-5 nell’elenco dei modelli (non Auto).
Modello di esempio: claude-sonnet-5-5
Importante
Solo OpenAI Chat Completions (POST /v1/chat/completions). Le richieste passano dai server Warp: la chiave è conservata localmente, ma trasmessa al backend Warp in ogni richiesta. Auto e router personalizzati consumano sempre crediti Warp; gli agenti cloud non usano questo endpoint. Disponibile nei piani Free e a pagamento per persone e team fino a 10 membri. Scegli modelli per cui il catalogo attuale dichiari OpenAI Chat. Nello snapshot 2026-09-30 gemini-3.6-flash ha questo formato; per altri Gemini controlla le schede. Il formato nativo Gemini non usa questo percorso. La presenza del metodo nel catalogo non equivale a una prova dal vivo della specifica versione del client.
Pannello Cline → ingranaggio (Settings) → API Provider = «OpenAI Compatible» → campi Base URL, API Key, Model ID. Seconda opzione: API Provider = «Anthropic» → seleziona «Use custom base URL».
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
OpenAI Compatible (consigliato):
API Provider: OpenAI Compatible
Base URL: https://api.ailoot.ai/v1
API Key: sk-...
Model ID: claude-sonnet-5-5 (oppure gpt-6.1-sol, deepseek-v4-pro, qwen3.8-max)
Model Configuration: Context Window e Max Output Tokens — in base al modello; Image Support — solo per i modelli che comprendono le immagini.
Anthropic (Messages):
API Provider: Anthropic
Anthropic API Key: sk-...
[x] Use custom base URL → https://api.ailoot.ai
Modello di esempio: claude-sonnet-5-5
Importante
OpenAI Compatible usa /v1/chat/completions, quindi l’indirizzo include /v1. L’opzione Anthropic usa /v1/messages con indirizzo senza /v1, ma nel suo elenco dei modelli compaiono solo nomi Anthropic — gli altri modelli Ailoot sono disponibili tramite OpenAI Compatible. La modalità agente richiede un modello con chiamate agli strumenti. I modelli Gemini 3.1 Pro non sono disponibili tramite chat/completions (hanno solo i formati Gemini e Anthropic) — qui usa gemini-3.6-flash.
Pannello Roo Code → ingranaggio → API Provider = «OpenAI Compatible» → Base URL, API Key, Model; opzionalmente Model Configuration (Max Output Tokens, Context Window, Image Support, Computer Use, prezzi). Il provider Anthropic ha la casella «Use custom base URL».
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
API Provider: OpenAI Compatible
Base URL: https://api.ailoot.ai/v1
API Key: sk-...
Model: gpt-6.1-sol (oppure claude-sonnet-5-5, kimi-k3, glm-5.3)
Alternativa tramite Anthropic:
API Provider: Anthropic, API key sk-..., [x] Use custom base URL → https://api.ailoot.ai
Modello di esempio: gpt-6.1-sol
Importante
Roo Code chiama gli strumenti solo nel formato OpenAI, quindi il modello deve supportare tools in /v1/chat/completions. L’opzione Anthropic usa /v1/messages con indirizzo senza /v1.
Settings (ingranaggio) → scheda Providers → in basso «Custom provider» → Provider ID, Display name, Provider API = «OpenAI Compatible», Base URL, API key, Models (elenco recuperato da /v1/models). Le impostazioni sono salvate in kilo.json.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Provider ID: ailoot
Display name: Ailoot
Provider API: OpenAI Compatible
Base URL: https://api.ailoot.ai/v1
API key: sk-...
Models: seleziona dall’elenco, per esempio claude-sonnet-5-5, gpt-6.1-sol, deepseek-v4-pro
Modello di esempio: deepseek-v4-pro
Importante
Kilo richiede {Base URL}/models e mostra da solo l’elenco dei modelli — il nostro GET /v1/models restituisce l’intero catalogo. Puoi anche specificare l’indirizzo completo .../v1/chat/completions. Sono supportati header personalizzati.
File ~/.continue/config.yaml (oppure editor di configurazione Continue): voce in models[] con provider: openai e apiBase.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
name: Ailoot
version: 0.0.1
schema: v1
models:
- name: Ailoot Claude Sonnet 5.5
provider: openai
model: claude-sonnet-5-5
apiBase: https://api.ailoot.ai/v1
apiKey: sk-...
- name: Ailoot GPT-6.1 Sol
provider: openai
model: gpt-6.1-sol
apiBase: https://api.ailoot.ai/v1
apiKey: sk-...
# useResponsesApi: false # solo se occorre forzare l'uso di /chat/completions
Modello di esempio: claude-sonnet-5-5
Importante
apiBase deve terminare con /v1. Per nomi delle serie gpt-5/o Continue può scegliere da solo /v1/responses; i nostri gpt-* supportano sia /v1/responses sia /v1/chat/completions, mentre useResponsesApi: false forza chat/completions. useLegacyCompletionsEndpoint non serve.
Agent Settings (agent::OpenSettings) → LLM Providers → Add Provider; oppure settings.json → language_models.openai_compatible / language_models.anthropic_compatible. La chiave è nella finestra delle impostazioni (conservata nel portachiavi di sistema) o nella variabile <ID DEL PROVIDER IN MAIUSCOLO>_API_KEY.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Per openai_compatible indirizzo con /v1 (usa /v1/chat/completions; capabilities.chat_completions = false passa il modello a /v1/responses). Per anthropic_compatible indirizzo senza /v1 (usa /v1/messages; Zed invia la chiave in x-api-key — Ailoot lo accetta). Per impostazione predefinita images = false e parallel_tool_calls = false. Zed può trasmettere immagini, ma attiva images solo per un modello specifico la cui scheda attuale dichiari input image nel formato API scelto. Negli esempi GPT e Claude images = false: lo snapshot 2026-09-30 dichiara solo testo per questi modelli. Ad esempio gemini-3.6-flash nello snapshot dichiara input image per OpenAI Chat; il supporto effettivo dipende dalla scheda e dal formato. Per modelli di ragionamento c’è reasoning_effort. I valori max_tokens dell’esempio sono la dimensione del contesto; consulta i limiti esatti nel catalogo dei modelli.
Selezione del modello nella chat → Manage Language Models (ingranaggio) → Add Models → Custom Endpoint → VS Code apre chatLanguageModels.json. (La vecchia impostazione github.copilot.chat.customOAIModels è obsoleta.)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
url è il percorso COMPLETO dell’endpoint. Valori apiType: chat-completions, responses (url .../v1/responses), messages (url .../v1/messages). BYOK funziona senza un piano Copilot o accesso GitHub, ma solo per chat/agente — i suggerimenti inline restano su Copilot. Gli amministratori delle organizzazioni (Business/Enterprise) possono disabilitare la policy BYOK. I limiti dei token sopra sono esempi: usa i valori del catalogo. In questi esempi vision = false: lo snapshot del catalogo 2026-09-30 dichiara solo testo per GPT/OpenAI Chat e Claude/Anthropic Messages. Se la tua versione VS Code offre vision, attivalo solo per un modello la cui scheda attuale dichiari input image nel formato API scelto; la presenza del campo nel client non conferma il supporto delle immagini nel modello scelto.
Settings | Tools | AI Assistant | Providers & API keys → Third-party AI providers → OpenAI-compatible → URL, API Key → Test Connection → Apply → AI Chat / Models Assignment
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Provider: OpenAI-compatible
URL: https://api.ailoot.ai/v1
API Key: sk-...
Modello di esempio: claude-sonnet-5-5
Importante
Seleziona OpenAI-compatible, inserisci https://api.ailoot.ai/v1 in URL e la tua API Key. Premi Test Connection, poi Apply e scegli un modello in AI Chat. Assegnalo alle funzioni dell’IDE in Models Assignment. Attiva Tool calling solo se il modello supporta gli strumenti; il completamento del codice si configura separatamente.
Xcode → Settings → Intelligence → Chat → Add a Chat Provider → Internet Hosted → URL, API Key, API Key Header, descrizione → Add.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Type: Internet Hosted
URL: https://api.ailoot.ai (SENZA /v1 — Xcode aggiunge autonomamente /v1/models e /v1/chat/completions)
API Key: sk-...
API Key Header: x-api-key
Description: Ailoot
→ poi seleziona i modelli dall’elenco (per esempio claude-sonnet-5-5, gpt-6.1-sol)
Modello di esempio: claude-sonnet-5-5
Importante
Apple richiede che il provider supporti Chat Completions e risponda a {URL}/v1/models e {URL}/v1/chat/completions. Ailoot accetta la chiave in x-api-key e in Authorization: Bearer (se scegli Authorization, secondo le segnalazioni Xcode aggiunge da solo il prefisso Bearer). Gli agenti Xcode si configurano separatamente e non rientrano in questa istruzione.
opts per yetone/avante.nvim in lazy.nvim: opts.providers.<nome> con __inherited_from = 'openai' (provider OpenAI compatibile personalizzato) oppure override di providers.claude.endpoint; chiave dalla variabile indicata in api_key_name (nomi AVANTE_* supportati).
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
opts = {
provider = "ailoot",
providers = {
ailoot = {
__inherited_from = "openai",
endpoint = "https://api.ailoot.ai/v1",
api_key_name = "AILOOT_API_KEY",
model = "claude-sonnet-5-5",
},
claude = {
endpoint = "https://api.ailoot.ai", -- Anthropic Messages, senza /v1
model = "claude-sonnet-5-5",
},
},
}
-- nel terminale: export AILOOT_API_KEY=sk-...
-- il provider claude legge AVANTE_ANTHROPIC_API_KEY o ANTHROPIC_API_KEY
Modello di esempio: claude-sonnet-5-5
Importante
Nella wiki del plugin l’indirizzo OpenAI compatibile termina con /v1 (il plugin aggiunge /chat/completions). Il provider integrato claude usa un indirizzo come https://api.anthropic.com, quindi per Ailoot senza /v1. I provider personalizzati senza __inherited_from richiedono un indirizzo completo e proprie funzioni per interpretare la risposta.
require('codecompanion').setup({ adapters = { http = { ... } } }) tramite adapters.extend('openai_compatible', ...) oppure extend('anthropic', ...); poi interactions.chat/inline.adapter.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: gpt-6.1-sol
Importante
openai_compatible separa host (env.url, senza /v1) e percorso (env.chat_url). I valori env possono essere nomi di variabili d’ambiente, cmd:..., file:... o funzioni Lua. Anche l’adapter anthropic può essere esteso con un url personalizzato per /v1/messages.
init.el: registra il backend tramite gptel-make-openai (OpenAI Chat), gptel-make-anthropic (Messages) o gptel-make-gemini — ciascuno ha :host, :endpoint, :key, :stream, :models; poi imposta gptel-backend e gptel-model.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5
Importante
:host — solo il nome host (senza https:// e percorso); il percorso si imposta in :endpoint. gptel-make-anthropic invia gli header x-api-key e anthropic-version — Ailoot li accetta.
Preferences → AI-features → OpenAiCustom (oppure chiave ai-features.openAiCustom.customOpenAiModels in settings.json; finestra AI Configuration — Alt+A).
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Settings → Models → Add Model → Custom Model → API Format, Request URL (interruttore Full URL), Model ID, Display Name, API Key; opzionalmente Advanced Settings.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Formato OpenAI:
API Format: OpenAI Chat Completions
Full URL: OFF
Request URL: https://api.ailoot.ai/v1
Model ID: gpt-6.1-sol
API Key: sk-...
Formato Anthropic:
API Format: Anthropic Messages
Full URL: OFF
Request URL: https://api.ailoot.ai
Model ID: claude-sonnet-5-5
API Key: sk-...
Modello di esempio: gpt-6.1-sol
Importante
Con Full URL disattivato Trae aggiunge da solo il percorso del formato scelto (OpenAI: indirizzo con /v1, Anthropic: senza /v1). Con Full URL attivato inserisci https://api.ailoot.ai/v1/chat/completions oppure https://api.ailoot.ai/v1/messages. Model Series adatta le indicazioni alla famiglia del modello.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
UI: URL = https://api.ailoot.ai/v1
API Key = sk-...
Model IDs: vuoto (vengono recuperati da /v1/models) oppure aggiungi manualmente claude-sonnet-5-5, gpt-6.1-sol
Docker env:
OPENAI_API_BASE_URL=https://api.ailoot.ai/v1
OPENAI_API_KEY=sk-...
Modello di esempio: claude-sonnet-5-5
Importante
Formato OpenAI Chat Completions; URL obbligatoriamente con /v1 e senza barra finale. L’elenco dei modelli viene recuperato da /v1/models; con un catalogo ampio (252 modelli) conviene limitare Model IDs e attivare la cache dell’elenco (Cache Base Model List / ENABLE_BASE_MODELS_CACHE=True). Per gli embedding RAG esistono RAG_OPENAI_API_BASE_URL separati.
File librechat.yaml → endpoints.custom (chiave in .env tramite ${VAR}); per il formato Anthropic campo provider: 'anthropic'
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Un normale custom endpoint = OpenAI Chat Completions (baseURL con /v1). provider: 'anthropic' attiva il client nativo /v1/messages; nell’esempio della documentazione baseURL Anthropic è senza /v1 (https://api.anthropic.com), quindi per noi https://api.ailoot.ai. fetch: true recupera l’elenco da /v1/models.
Settings (ingranaggio) > Model Provider > + Add Provider > tipo di protocollo OpenAI / OpenAI Responses / Anthropic / Gemini
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Provider Name: Ailoot
Tipo: OpenAI (oppure OpenAI Responses / Anthropic)
API Key: sk-...
Base URL: https://api.ailoot.ai
→ Controlla l’anteprima dell’indirizzo finale sotto il campo: deve risultare https://api.ailoot.ai/v1/chat/completions (per Anthropic — https://api.ailoot.ai/v1/messages)
Models: + claude-sonnet-5-5, gpt-6.1-sol
Poi premi il pulsante Model Check
Modello di esempio: claude-sonnet-5-5
Importante
La documentazione conferma OpenAI, Anthropic, OpenAI Responses e Gemini e l’anteprima del percorso finale sotto il campo, ma non descrive le regole per aggiungere /v1 — fai riferimento all’anteprima. Tutti e tre i nostri formati (Chat Completions, Responses, Messages) sono adatti.
Impostazioni (pulsante nella barra laterale) > Model Provider > Add (in basso) > tipo OpenAI API Compatible
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Name: Ailoot
API Mode: OpenAI API Compatible
API Key: sk-...
API Host: https://api.ailoot.ai
API Path: (vuoto, percorso predefinito /v1/chat/completions)
Models: + gpt-6.1-sol, claude-sonnet-5-5 (vision è disattivato in questi esempi; tool_use dipende dalle funzionalità del modello selezionato)
Modello di esempio: gpt-6.1-sol
Importante
La documentazione indica API Host senza /v1 (esempio https://api.openai.com) e il percorso predefinito /v1/chat/completions. Esiste anche il tipo Google Gemini compatible, ma non è stato verificato per il nostro /v1beta. L’import della configurazione JSON (type: 'openai', apiHost, apiPath) è disponibile dalla 1.15.1 tramite chatbox://provider/import?config=<base64>. Per i GPT e Claude mostrati vision è disattivato: lo snapshot del catalogo 2026-09-30 dichiara solo testo nel formato OpenAI Chat. Se la tua versione Chatbox offre vision, attivalo solo per un modello la cui scheda attuale dichiari input image nel formato API scelto; poter allegare un’immagine nel client non dimostra che il modello la supporti.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
OPENAI_PROXY_URL è predefinito a https://api.openai.com/v1, quindi indichiamo l’indirizzo con /v1. ANTHROPIC_PROXY_URL è predefinito a https://api.anthropic.com (senza /v1). Tramite GOOGLE_PROXY_URL è formalmente possibile collegare il formato Gemini (https://api.ailoot.ai), ma non abbiamo verificato questa variante. Usa la modalità server: richieste dirette dal browser possono ancora essere rifiutate da Ailoot API per le regole CORS.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
OpenAI-compatible:
Provider name: Ailoot
Base URL: https://api.ailoot.ai/v1
API key: sk-...
Anthropic-compatible:
Provider name: Ailoot Claude
Base URL: https://api.ailoot.ai
API key: sk-...
Models: vengono recuperati da {base_url}/models oppure aggiunti manualmente con +: claude-sonnet-5-5
Modello di esempio: claude-sonnet-5-5
Importante
Documentazione: per i provider OpenAI compatibili Base URL deve includere /v1 (altrimenti 404); la barra finale viene rimossa. Per la modalità Anthropic c’è un esempio LiteLLM senza /v1. Le capacità del modello (tools, vision) per provider personalizzati si impostano manualmente. Sono supportate chiavi di riserva (retry solo per 401/403/429).
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Documentazione: con problemi di connessione aggiungi /v1 e NON aggiungere /chat/completions. L’elenco dei modelli viene recuperato se il server restituisce /v1/models (il nostro lo fa).
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
UI: Base URL = https://api.ailoot.ai/v1
API Key = sk-...
Chat Model Name = deepseek-v4-pro
Token context window = in base al modello
Docker .env:
LLM_PROVIDER='generic-openai'
GENERIC_OPEN_AI_BASE_PATH='https://api.ailoot.ai/v1'
GENERIC_OPEN_AI_MODEL_PREF='deepseek-v4-pro'
GENERIC_OPEN_AI_MODEL_TOKEN_LIMIT=128000
GENERIC_OPEN_AI_API_KEY='sk-...'
Modello di esempio: deepseek-v4-pro
Importante
Il provider è indicato nella documentazione come «per sviluppatori». Se necessario GENERIC_OPEN_AI_MODEL_MAX_TOKEN_KEY='max_completion_tokens'. Per gli embedding c’è un generic-openai embedder separato (EMBEDDING_BASE_PATH + GENERIC_OPEN_AI_EMBEDDING_API_KEY) — modello nemotron-3-embed tramite /v1/embeddings.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La documentazione descrive le variabili come sostituzione del backend host per OpenAI e Anthropic (per proxy ed endpoint personalizzati); dice «host», quindi indichiamo l’indirizzo senza /v1, ma non specifica il formato esatto del percorso — verifica dalla prima richiesta.
Settings > Models > (+) > OpenAI-compatible Server
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Friendly name: Ailoot
API Endpoint URL: https://api.ailoot.ai/v1/chat/completions
API Key: sk-...
Model ID: gpt-6.1-sol
Context length: in base al modello
Streaming: attiva
Modello di esempio: gpt-6.1-sol
Importante
Serve l’indirizzo completo di chat completions. Rendi questo servizio quello principale per usarlo con AI Command. Istruzione basata sulla guida BoltAI; in BoltAI 2 le finestre possono differire.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Model Hub > Model Providers > Add Provider > OpenAI-compatible
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Provider: OpenAI Compatible
Name: Ailoot
API Endpoint: https://api.ailoot.ai/v1
API Key: sk-...
Models: gpt-6.1-sol, claude-sonnet-5-5
Modello di esempio: gpt-6.1-sol
Importante
La documentazione conferma un provider OpenAI compatibile personalizzato, ma non il formato dell’indirizzo; /v1 è la radice standard OpenAI API, in caso di errore 404 verifica la variante senza /v1. Un endpoint Anthropic compatibile personalizzato non è descritto.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Per questa configurazione usa OpenAI Chat tramite il server NextChat. Nel deployment su Vercel o Docker imposta BASE_URL=https://api.ailoot.ai senza /v1, OPENAI_API_KEY, CUSTOM_MODELS e DEFAULT_MODEL. Esegui nuovamente il deployment del server dopo aver modificato queste variabili.
Settings > Copilot > BYOK > Add a provider > Add a custom provider
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Base URL: https://api.ailoot.ai/v1
API key: sk-...
Model ID: claude-sonnet-5-5 (oppure seleziona dall’elenco /v1/models)
Poi Test; attiva il modello in Basic > Agents > Quick Chat
Modello di esempio: claude-sonnet-5-5
Importante
L’elenco dei modelli viene recuperato da /v1/models, il modello può essere inserito manualmente. Se Test riesce ma Quick Chat non invia messaggi, attiva Enable CORS sul provider (la risposta arriva intera, senza streaming). Le chiavi sono conservate in Obsidian Keychain.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Provider: Custom
Name: Ailoot
Base URL: https://api.ailoot.ai/v1
API Key: sk-...
Poi aggiungi manualmente i modelli: gpt-6.1-sol, claude-sonnet-5-5
Modello di esempio: gpt-6.1-sol
Importante
La documentazione conferma Custom con API URL e chiave; non specifica il formato URL, /v1 è la radice standard OpenAI API. Il recupero automatico dei modelli è garantito solo per Ollama, LM Studio e Llamafile — per gli altri si aggiungono manualmente.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
base_url è un endpoint OpenAI compatibile senza il suffisso /chat/completions. Raycast rilegge il file senza riavvio. Se abilities non è specificato, tools e vision sono considerati non supportati. I modelli appaiono in Quick AI, AI Chat e AI Commands. Nell’esempio vision.supported = false: lo snapshot del catalogo 2026-09-30 dichiara solo testo per Claude/OpenAI Chat. Se la tua versione Raycast supporta questa impostazione, attiva vision solo per un modello la cui scheda attuale dichiari input image nel formato OpenAI Chat; il flag del client non conferma da solo il supporto delle immagini nell’API.
Models (barra laterale sinistra) > + Add Custom Model
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Name: Claude Sonnet 5.5 (Ailoot)
API Type: OpenAI Chat Completions
Endpoint: https://api.ailoot.ai/v1/chat/completions
Model ID: claude-sonnet-5-5
Custom Headers: Authorization = Bearer sk-...
Context Length: in base al modello
Test → Save
Modello di esempio: claude-sonnet-5-5
Importante
Endpoint va inserito come percorso completo. La chiave è trasmessa nell’header personalizzato Authorization: Bearer sk-... — accettato da Ailoot. La versione web TypingMind chiama l’API direttamente dal browser e CORS può attualmente bloccare le richieste; la versione desktop è più affidabile. Il tipo Gemini in TypingMind invia la chiave nell’header apiKey, non accettato da Ailoot — usa OpenAI Chat Completions.
Parametro del costruttore OpenAI(base_url=..., api_key=...) oppure variabili d’ambiente OPENAI_BASE_URL e OPENAI_API_KEY
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
import os
from openai import OpenAI
client = OpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
r = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role":"user","content":"Ciao"}])
print(r.choices[0].message.content)
# Responses API: client.responses.create(model="gpt-6.1-sol", input="Ciao")
# Embedding: client.embeddings.create(model="nemotron-3-embed", input=["testo"])
python3 ailoot-openai-python-sdk.py
Modello di esempio: gpt-6.1-sol, claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-max (chat); nemotron-3-embed (embeddings)
Importante
Indirizzo con /v1: l’SDK aggiunge da solo /chat/completions, /responses, /embeddings, /images/*, /audio/*. Funzionano Chat Completions e Responses (Responses per i modelli con questo formato nel catalogo). Streaming e strumenti sono standard. Gli errori Ailoot arrivano in JSON con Request ID e vengono intercettati come openai.APIStatusError.
Opzione del costruttore new OpenAI({ baseURL, apiKey }); per impostazione predefinita l’SDK legge la variabile d’ambiente OPENAI_BASE_URL
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: claude-sonnet-5-5, gpt-6.1-sol, grok-4.7
Importante
Il README mostra baseURL; la lettura di OPENAI_BASE_URL è nei sorgenti del client (src/client.ts), il valore predefinito è https://api.openai.com/v1. Indica l’indirizzo Ailoot con /v1. Sono disponibili sia chat.completions sia responses.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Modello di esempio: claude-sonnet-5-5, claude-opus-5-5; anche tramite /v1/messages gpt-6.1-sol, deepseek-v4-pro, gemini-3.6-flash
Importante
Indirizzo SENZA /v1: l’SDK aggiunge da solo /v1/messages. Il gateway accetta la chiave in x-api-key (come la invia l’SDK) e in Authorization: Bearer. Funzionano streaming, strumenti e /v1/messages/count_tokens. Elaborazione in batch (Batches) e Files API non sono dichiarati nel catalogo Ailoot.
Provider: createOpenAICompatible({ name, baseURL, apiKey }) da @ai-sdk/openai-compatible; createAnthropic({ baseURL, apiKey }) da @ai-sdk/anthropic; createGoogleGenerativeAI({ baseURL, apiKey }) da @ai-sdk/google; createOpenAI({ baseURL }) oppure OPENAI_BASE_URL
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: deepseek-v4-pro (compatibile con OpenAI), claude-sonnet-5-5 (Anthropic), gemini-3.6-flash (Gemini)
Importante
I provider usano indirizzi diversi: OpenAI compatibile e Anthropic con /v1 (predefinito Anthropic https://api.anthropic.com/v1), Google con /v1beta (predefinito https://generativelanguage.googleapis.com/v1beta). @ai-sdk/openai usa per impostazione predefinita Responses API; per modelli senza metodo responses usa openai.chat("id") o createOpenAICompatible.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(model="gpt-6.1-sol", base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
print(llm.invoke("Ciao").content)
from langchain_anthropic import ChatAnthropic
claude = ChatAnthropic(model="claude-sonnet-5-5", base_url="https://api.ailoot.ai", api_key=os.environ["AILOOT_API_KEY"])
Modello di esempio: gpt-6.1-sol, qwen3.8-max (ChatOpenAI); claude-sonnet-5-5 (ChatAnthropic)
Importante
ChatOpenAI: indirizzo con /v1. Secondo la documentazione supporta solo la specifica ufficiale OpenAI: campi non standard come reasoning_content di modelli esterni non vengono conservati. Per Claude è meglio ChatAnthropic: indirizzo senza /v1, l’SDK aggiunge da solo /v1/messages. Il parametro base_url e le variabili ANTHROPIC_API_URL/ANTHROPIC_BASE_URL di ChatAnthropic sono descritti nella documentazione della classe nei sorgenti (langchain_anthropic/chat_models.py), non nella pagina di integrazione. Il flag use_responses_api attiva la modalità Responses in ChatOpenAI.
crewai.LLM(model=..., base_url=..., api_key=...); variabili OPENAI_API_KEY e OPENAI_BASE_URL; per Claude — provider nativo anthropic/ con base_url
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/messages e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
import os
from crewai import LLM
# formato compatibile con OpenAI
llm = LLM(model="openai/gpt-6.1-sol", base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
# Anthropic Messages
claude = LLM(model="anthropic/claude-sonnet-5-5", base_url="https://api.ailoot.ai", api_key=os.environ["AILOOT_API_KEY"], max_tokens=4096)
Modello di esempio: openai/gpt-6.1-sol, anthropic/claude-sonnet-5-5
Importante
Il prefisso openai/ o anthropic/ seleziona il provider in CrewAI; nella richiesta viene inviato id senza prefisso. Per OpenAI l’indirizzo include /v1, per Anthropic senza /v1. La documentazione descrive anche il flag custom_openai=True per qualsiasi gateway OpenAI compatibile. Per Anthropic max_tokens è obbligatorio.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
import os
from google import genai
from google.genai import types
client = genai.Client(
api_key=os.environ["AILOOT_API_KEY"],
http_options=types.HttpOptions(base_url="https://api.ailoot.ai"))
r = client.models.generate_content(model="gemini-3.6-flash", contents="Ciao")
print(r.text)
Modello di esempio: gemini-3.6-flash, gemini-3.1-pro
Importante
Indirizzo senza /v1beta: l’SDK costruisce da solo /v1beta/models/{model}:generateContent. La chiave viene inviata nell’header x-goog-api-key — Ailoot lo accetta. Sono disponibili solo modelli con formato Gemini. La documentazione della versione JavaScript (@google/genai) non descrive l’indirizzo personalizzato, quindi non la riportiamo qui.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Modello di esempio: openai/claude-sonnet-5-5, openai/qwen3.8-max, openai/nemotron-3-embed
Importante
Il prefisso openai/ indica il protocollo OpenAI compatibile; Ailoot riceve id senza prefisso. LiteLLM aggiunge da solo /chat/completions e /embeddings; secondo la documentazione, con un errore Not Found l’indirizzo deve terminare con /v1.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: openai/claude-sonnet-5-5, openai/gpt-6.1-sol
Importante
Il proxy è utile se vuoi distribuire al team chiavi interne basate su un’unica chiave Ailoot. Gli addebiti Ailoot sono sulla chiave indicata in api_key. Indirizzo con /v1.
Pacchetto llama-index-llms-openai-like, classe OpenAILike(api_base=..., api_key=..., model=..., is_chat_model=True)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
pip install llama-index-llms-openai-like
import os
from llama_index.llms.openai_like import OpenAILike
llm = OpenAILike(
model="deepseek-v4-pro",
api_base="https://api.ailoot.ai/v1",
api_key=os.environ["AILOOT_API_KEY"],
is_chat_model=True,
is_function_calling_model=True,
context_window=128000)
print(llm.complete("Ciao"))
Modello di esempio: deepseek-v4-pro, claude-sonnet-5-5, gpt-6.1-sol
Importante
Indirizzo con /v1. is_chat_model=True è obbligatorio, altrimenti la classe userà il percorso obsoleto /completions. is_function_calling_model=True permette agli agenti di usare strumenti. Imposta context_window dalla scheda del modello nel catalogo Ailoot.
In Agent: model: { id: "<provider>/<modello>", url: "<indirizzo di base>", apiKey, api?: "chat" | "responses" }
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
id: "ailoot-agent",
name: "Ailoot Agent",
instructions: "Rispondi in russo",
model: {
id: "ailoot/claude-sonnet-5-5",
url: "https://api.ailoot.ai/v1",
apiKey: process.env.AILOOT_API_KEY
// api: "responses" // solo per i modelli che supportano il metodo responses
}
});
La chiave viene letta dalla variabile AILOOT_API_KEY — impostala prima dell’avvio:
export AILOOT_API_KEY="sk-..." # aggiungi a ~/.zshrc o ~/.bashrc
setx AILOOT_API_KEY "sk-..." # poi riavvia il terminale
Modello di esempio: ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol
Importante
url contiene l’indirizzo di base con /v1, non il percorso completo verso /chat/completions. Si usa Chat Completions per impostazione predefinita; api: "responses" passa a Responses API. La forma id "provider/modello" invia al gateway il solo id del modello. Il campo apiKey nell’oggetto model è mostrato nella documentazione in un esempio con header; non è descritto separatamente insieme a url.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
import os
from agents import Agent, Runner, AsyncOpenAI, OpenAIChatCompletionsModel, set_tracing_disabled
set_tracing_disabled(disabled=True)
client = AsyncOpenAI(max_retries=0, base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"])
model = OpenAIChatCompletionsModel(model="claude-sonnet-5-5", openai_client=client)
agent = Agent(name="Assistente", instructions="Rispondi in russo", model=model)
print(Runner.run_sync(agent, "Ciao").final_output)
Modello di esempio: claude-sonnet-5-5, gpt-6.1-sol
Importante
Indirizzo con /v1. Disabilita il tracing tramite set_tracing_disabled(True): altrimenti l’SDK tenterà di inviare tracce a OpenAI senza una chiave OpenAI. Chat Completions è disponibile solo per i modelli per cui questo metodo è indicato nel catalogo ed è accessibile alla tua chiave; Responses (predefinito nell’SDK) solo per i modelli con il metodo responses nel catalogo. Gli strumenti integrati di OpenAI (ricerca web, file) non sono garantiti tramite un gateway di terze parti.
OpenAIProvider(base_url=..., api_key=...) con il modello OpenAIChatModel (Chat Completions) oppure OpenAIResponsesModel (Responses); alternativa — variabile OPENAI_BASE_URL
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
import os
from pydantic_ai import Agent
from pydantic_ai.models.openai import OpenAIChatModel
from pydantic_ai.providers.openai import OpenAIProvider
model = OpenAIChatModel("deepseek-v4-pro",
provider=OpenAIProvider(base_url="https://api.ailoot.ai/v1", api_key=os.environ["AILOOT_API_KEY"]))
agent = Agent(model)
print(agent.run_sync("Ciao").output)
Modello di esempio: deepseek-v4-pro, gpt-6.1-sol (per OpenAIResponsesModel)
Importante
Indirizzo con /v1. La documentazione usa per impostazione predefinita OpenAIResponsesModel: sceglilo solo per modelli con metodo responses; per gli altri OpenAIChatModel.
Credentials → OpenAI → campo Base URL (predefinito https://api.openai.com/v1); Credentials → Anthropic → Base URL (predefinito https://api.anthropic.com); Credentials → Google Gemini(PaLM) Api → Host (predefinito https://generativelanguage.googleapis.com). Poi nodi OpenAI Chat Model / Anthropic Chat Model / Google Gemini Chat Model
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
OpenAI credential:
API Key: sk-...
Base URL: https://api.ailoot.ai/v1
Anthropic credential:
API Key: sk-...
Base URL: https://api.ailoot.ai
Google Gemini(PaLM) Api credential:
Host: https://api.ailoot.ai
API Key: sk-...
Nodo OpenAI Chat Model → Model: By ID → gpt-6.1-sol (l’opzione Use Responses API è solo per i modelli che supportano il metodo responses)
Modello di esempio: gpt-6.1-sol / deepseek-v4-pro (OpenAI), claude-sonnet-5-5 (Anthropic), gemini-3.6-flash (Gemini)
Importante
La verifica delle credenziali chiama /models (OpenAI), /v1/models (Anthropic) e /v1beta/models (Gemini); Ailoot dispone di tutti e tre i percorsi. Le pagine di documentazione n8n non descrivono Base URL: il campo è nelle credenziali stesse (sorgenti OpenAiApi.credentials.ts e AnthropicApi.credentials.ts, etichetta «Override the default base URL for the API»). In n8n Cloud non scegliere «Use Gateway credits», altrimenti le richieste non passeranno da Ailoot.
Integrations → Model Provider → installa il plugin OpenAI-API-compatible → Add Model (campi: Model Type, Model Name, API Key, API Base URL, Completion mode, Model context size)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Model Type: LLM
Model Name: claude-sonnet-5-5
API Key: sk-...
API Base URL: https://api.ailoot.ai/v1
Completion mode: Chat
Model context size: in base alla scheda del modello nel catalogo Ailoot
Per Text Embedding:
Model Name: nemotron-3-embed
API Base URL: https://api.ailoot.ai
Modello di esempio: claude-sonnet-5-5, gpt-6.1-sol, qwen3.8-max; nemotron-3-embed (embeddings)
Importante
Solo proprietario e amministratori del workspace possono gestire i provider. Secondo il README del plugin: per LLM l’indirizzo include /v1; per embedding, rerank, STT e TTS il plugin aggiunge da solo la versione API, quindi l’indirizzo non deve includere /v1 (altrimenti risulta /v1/v1). Aggiungi ogni modello Ailoot come voce separata; abilita input immagini e streaming nelle impostazioni del modello.
Nodo ChatOpenAI o ChatOpenAI Custom → Connect Credential (chiave) → Additional Parameters → Base Path (e Base Options per gli header)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Credential (OpenAI API): sk-...
Nodo ChatOpenAI Custom:
Model Name: deepseek-v4-pro
Additional Parameters → Base Path: https://api.ailoot.ai/v1
Modello di esempio: deepseek-v4-pro, claude-sonnet-5-5, gpt-6.1-sol
Importante
L’elenco dei modelli in ChatOpenAI è fisso; per id Ailoot arbitrari usa ChatOpenAI Custom, dove il nome del modello si inserisce manualmente. Base Path con /v1. Per gli embedding c’è il nodo OpenAI Embeddings Custom.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
API Key: sk-...
Base Url: https://api.ailoot.ai/v1
Options → Chat Model: gpt-6.1-sol
Voice Assistants → Conversation agent: Extended OpenAI Conversation
Modello di esempio: gpt-6.1-sol, claude-sonnet-5-5
Importante
È un componente di terze parti, non un’integrazione ufficiale. Il controllo dei dispositivi usa chiamate a funzioni (tools) in Chat Completions, quindi scegli modelli con supporto degli strumenti. L’integrazione ufficiale OpenAI Conversation non supporta l’indirizzo personalizzato.
Profilo → Settings → Model Providers → OpenAI Compatible (campi Base URL e API Key; variabili OPENAI_COMPATIBLE_BASE_URL e OPENAI_COMPATIBLE_API_KEY). Alternativa: componente OpenAI → campo OpenAI API Base
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Settings → Model Providers → OpenAI Compatible:
Base URL: https://api.ailoot.ai/v1
API Key: sk-...
oppure tramite le variabili d’ambiente:
export OPENAI_COMPATIBLE_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_COMPATIBLE_API_KEY="sk-..."
Poi seleziona OpenAI Compatible → claude-sonnet-5-5 nei componenti Language Model / Agent
Modello di esempio: claude-sonnet-5-5, gpt-6.1-sol, nemotron-3-embed (Embedding Model)
Importante
Langflow verifica la connessione e recupera l’elenco da /v1/models; i modelli appaiono in Language Models e Embedding Models. I modelli necessari vanno poi attivati manualmente. Il provider viene installato insieme a langflow.
Il modulo OpenAI integrato funziona solo con un account OpenAI. Usa HTTP → Make a request: URL, Method, Headers, Body type Raw / JSON
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Modulo: HTTP → Make a request
URL: https://api.ailoot.ai/v1/chat/completions
Method: POST
Headers:
Authorization: Bearer sk-...
Content-Type: application/json
Body (JSON):
{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"{{1.text}}"}]}
Parse response: Yes → la risposta si trova in choices[].message.content
Modello di esempio: gpt-6.1-sol, claude-sonnet-5-5
Importante
È un modulo HTTP generico, non un provider Ailoot dedicato: la documentazione descrive un indirizzo HTTPS arbitrario. È meglio conservare la chiave in una connessione con chiave API (Make lo consiglia invece di inviarla negli header). Lo streaming non serve in Make: invia senza stream.
I framework Telegram non hanno un livello LLM proprio: il gestore dei messaggi chiama OpenAI SDK con base_url Ailoot (oppure Anthropic SDK con base_url senza /v1)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Salva il codice Python come ailoot-telegram-bot.py. Installa le dipendenze, imposta entrambe le variabili d’ambiente ed esegui il file. Invia Hello al bot e verifica la risposta testuale. In caso di errore, conserva il Request ID e controlla il risultato originale prima di un’altra generazione.
python3 -m pip install "aiogram>=3,<4" openai
ailoot-telegram-bot.py
import asyncio
import os
from aiogram import Bot, Dispatcher, F
from aiogram.types import Message
from openai import AsyncOpenAI, APIError
async def main():
dp = Dispatcher()
async with AsyncOpenAI(
base_url="https://api.ailoot.ai/v1",
api_key=os.environ["AILOOT_API_KEY"],
max_retries=0,
) as llm:
@dp.message(F.text)
async def reply(message: Message):
try:
result = await llm.chat.completions.create(
model="claude-sonnet-5-5",
messages=[{"role": "user", "content": message.text}],
)
content = result.choices[0].message.content or "—"
for start in range(0, len(content), 4000):
await message.answer(content[start:start + 4000])
except APIError as error:
await message.answer(
f"{type(error).__name__}; Request ID: "
f"{getattr(error, 'request_id', None) or '—'}"
)
bot = Bot(token=os.environ["TELEGRAM_BOT_TOKEN"])
await dp.start_polling(bot)
if __name__ == "__main__":
asyncio.run(main())
Modello di esempio: claude-sonnet-5-5, deepseek-v4-pro, qwen3.8-flash
Importante
I framework Telegram non hanno un proprio livello per modelli di IA: l’indirizzo Ailoot si imposta in OpenAI SDK nel bot. Con saldo zero Ailoot restituisce un errore 402 chiaro con Request ID — mostralo all’utente del bot evitando che il bot si arresti.
L’applicazione ChatGPT (OpenAI) in Zapier funziona solo con OpenAI. Usa Webhooks by Zapier → Custom Request (Method, URL, Data, Headers)
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Azione: Webhooks by Zapier → Custom Request
Method: POST
URL: https://api.ailoot.ai/v1/chat/completions
Data (raw JSON):
{"model":"claude-sonnet-5-5","messages":[{"role":"user","content":"Ciao"}]}
Headers:
Authorization | Bearer sk-...
Content-Type | application/json
Modello di esempio: claude-sonnet-5-5, gpt-6.1-sol
Importante
È una richiesta HTTP generica: Zapier non ha un provider pronto con un campo per l’indirizzo di base. Custom Request invia Data così com’è, senza interpretarlo, quindi il JSON va verificato prima. Webhooks by Zapier è disponibile nei piani Zapier a pagamento.
~/.gemini/antigravity-cli/settings.json → "modelProvider": "gemini"; variabili GEMINI_API_KEY e GOOGLE_GEMINI_BASE_URL
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1beta/models/{model}:generateContent e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Il protocollo è Gemini REST nativo (streamGenerateContent, chiave in X-Goog-Api-Key), percorso https://api.ailoot.ai/v1beta/... Per una domanda agy invia due richieste: titolo della conversazione e risposta. L’agente riserva a ogni passaggio molto più di una chat normale, quindi mantieni un margine nel saldo. La scheda è nella sezione «In verifica»: configurazione ricavata dalla documentazione, ma il client non è ancora stato provato dal vivo tramite Ailoot. Se modelProvider = gemini e GEMINI_API_KEY è vuoto, la CLI non parte.
cline auth → provider API personalizzati → OpenAI Compatible: Base URL, API Key, Model ID; il flag -P/--provider seleziona il provider
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
cline auth
# API Provider: OpenAI Compatible
# Base URL: https://api.ailoot.ai/v1
# API Key: sk-...
# Model ID: claude-sonnet-5-5
cline "Esegui i test e correggi gli errori"
Modello di esempio: claude-sonnet-5-5
Importante
I campi Base URL / API Key / Model ID sono descritti nella documentazione Cline per OpenAI Compatible. Le etichette esatte della procedura cline auth non sono riportate nella documentazione CLI — confrontale con la schermata.
GitHub conferma il supporto degli endpoint personalizzati. La schermata ufficiale mostra Provider Name, API Key e API Type: Chat Completions, ma non un esempio di URL. Qui non viene quindi fornita una configurazione Ailoot pronta da copiare. JetBrains AI Assistant è l’alternativa documentata in questo IDE. Chiedi al supporto ufficiale del plugin di chiarire i requisiti dell’URL.
Cursor Settings → Models → API Keys → OpenAI API Key + interruttore «Override OpenAI Base URL»; poi aggiungi l’ID del modello ai tuoi modelli.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
OpenAI API Key: sk-...
Override OpenAI Base URL: https://api.ailoot.ai/v1
Modello personalizzato: gpt-6.1-sol (aggiungi, attiva e seleziona nella chat)
Modello di esempio: gpt-6.1-sol
Importante
La documentazione ufficiale attuale di Cursor non descrive l’indirizzo personalizzato: elenca solo chiavi OpenAI/Anthropic/Google/Azure/Bedrock, dice che le proprie chiavi funzionano solo nella chat (Tab resta sui modelli Cursor) e che tutte le richieste passano dai server Cursor (l’indirizzo deve essere pubblico — api.ailoot.ai è pubblico). L’interruttore dell’indirizzo è nell’interfaccia, ma sul forum Cursor vengono segnalati problemi: si applica a tutti i modelli, la modalità Agent potrebbe non usare la propria chiave e in alcune build 3.15.x il campo non accetta input.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Provider: OpenAI Chat
API Key: sk-...
Base Path: https://api.ailoot.ai/v1
Model: gpt-6.1-sol
Modello di esempio: gpt-6.1-sol
Importante
La documentazione del plugin menziona il provider Custom, ma non descrive il campo dell’indirizzo e il suo formato; la configurazione è basata sull’interfaccia del plugin — confrontala con la finestra delle impostazioni.
Cmd/Ctrl+Shift+P → Open config.json → voce in models[] (PearAI è un fork di Continue).
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Non è stato possibile verificare la documentazione ufficiale PearAI (il sito non era disponibile), il repository non è aggiornato da tempo. Il formato della configurazione segue Continue — verifica nell’applicazione.
Chat → selezione del modello → Manage models → Add custom model → provider OpenAI (custom endpoint) → indirizzo, chiave, modello.
Configurazione
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
Il blog Visual Studio (29.09.2026) ha annunciato indirizzi personalizzati per OpenAI e Ollama in VS 2026 Stable, ma la documentazione descrive ancora solo chiavi OpenAI/Anthropic/Google senza il campo indirizzo, quindi nomi dei campi e formato dell’indirizzo non sono ancora confermati. Solo chat; non disponibile su piani Copilot Business/Enterprise.
Prima dell’avvio, richiedi GET /v1/models con la tua chiave Ailoot. Scegli un ID esatto di modello i cui metodi includano POST /v1/chat/completions e usalo nella configurazione. Per gli agenti, verifica anche gli strumenti e le funzioni richieste dalla tua versione del client.
La configurazione è ricavata dal codice sorgente Void, non dalla documentazione utente. Il repository Void è archiviato, l’editor non viene più sviluppato — adatto solo a chi lo usa già.
Nessun risultato. Se l’applicazione supporta un indirizzo OpenAI o Anthropic API personalizzato, probabilmente funzionerà — ecco cosa impostare.
Non ancora adatti
In queste applicazioni non puoi indicare un indirizzo API personalizzato. Accanto trovi le alternative.
Applicazione
Perché non è adatta
Alternativa
Cursor CLI (cursor-agent)
Funziona solo sui modelli Cursor; non permette un indirizzo API personalizzato.
Claude Code, Codex CLI oppure opencode
Auggie CLI (Augment Code)
Accesso tramite account Augment; non puoi indicare un provider esterno.
Claude Code oppure opencode
Windsurf / Devin Desktop
Accetta solo la chiave Anthropic per alcuni modelli Claude; non permette un indirizzo personalizzato.
Cline, Roo Code oppure Kilo Code in VS Code
Kiro
Non sono disponibili chiave e indirizzo API personalizzati.
Cline oppure Roo Code
Google Antigravity (IDE)
Non c’è una configurazione ufficiale per un provider personalizzato; sconsigliamo patch di terze parti.
Antigravity CLI oppure Gemini CLI
Visual Studio con Copilot Business o Enterprise
Su questi piani Copilot i modelli personalizzati non sono disponibili.
Piano personale Copilot — scheda Visual Studio 2026
Completamento automatico Cursor Tab
Funziona sempre sui modelli Cursor, anche con la propria chiave.
La chat Cursor si configura separatamente — scheda Cursor
Enchanted
Funziona solo con l’API Ollama.
Open WebUI oppure Chatbox
Smart Connections (Obsidian)
Le API esterne sono disponibili solo in Smart Chat Pro a pagamento.
Obsidian Copilot
Witsy, 5ire
Non abbiamo trovato una descrizione ufficiale dell’indirizzo API personalizzato.
Cherry Studio oppure Jan
Make: modulo OpenAI integrato
Si connette solo a un account OpenAI.
Modulo HTTP → Make a request — scheda Make
Zapier: applicazione ChatGPT (OpenAI)
Non c’è un campo per l’indirizzo personalizzato.
Webhooks by Zapier → Custom Request — scheda Zapier
Home Assistant: OpenAI Conversation
L’integrazione incorporata funziona solo con l’indirizzo OpenAI.
Extended OpenAI Conversation da HACS — scheda Home Assistant
aiogram, python-telegram-bot, grammY, Telegraf
I framework per bot non si connettono direttamente ai modelli.
OpenAI o Anthropic SDK nel bot — scheda Bot Telegram
Maggiori dettagli
Chiamate API per intelligenza artificiale nei client
Come imposto l’URL delle API e la chiave nel mio client?
Agenti, editor, chat e SDK che accettano la chiave Ailoot. Il pulsante «Configura» mostra dove inserire indirizzo e chiave e un config pronto da copiare.
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 il formato OpenAI, Anthropic o Gemini supportato dal tuo client. Consulta la scheda del modello Ailoot per trovare un metodo API e un ID modello compatibili; il supporto di un formato non significa che ogni modello supporti tutti i formati.
Cosa devo configurare nel mio client?
Imposta la chiave API Ailoot, l'indirizzo API e un ID modello compatibile con il metodo del client. L'SDK OpenAI usa https://api.ailoot.ai/v1; gli SDK Anthropic e Gemini usano https://api.ailoot.ai. Mantieni i campi della richiesta indicati nell'esempio per quel formato.
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.
Cosa devo controllare se un client già collegato non funziona?
Verifica che il client invii il formato OpenAI, Anthropic o Gemini previsto all'indirizzo API corrispondente con la tua chiave API Ailoot. Conferma l'ID del modello e il metodo, poi confronta l'errore restituito con la guida del client. Invia l'errore e l'ID della richiesta a support@ailoot.ai senza condividere la tua chiave.
Posso usare Ailoot in un prodotto a pagamento?
Sì. Collega API a SaaS, app o bot secondo offerta e licenza Ailoot. Per rivendita richiedi condizioni scritte e licenza specifica del progetto.
Come richiedo una licenza per rivenditori?
Scrivi a support@ailoot.ai spiegando cosa fa il tuo prodotto, chi lo usa e come fornisci l'accesso. Richiedi una licenza per rivenditori e condizioni scritte per il tuo progetto.