Questa pagina è tradotta dalla documentazione inglese. Comandi, identificatori ed esempi restano invariati. Runtime 7.24.4 · SDK 2.6.7. Testo inglese

Avvio rapido delle API del livello gratuito

Stato: Attivo Ambito: stato attuale Ultima revisione: 2026-08-28 Responsabile: runtime di ax-code

AX Code non fornisce quota di modello. Un’esecuzione «gratuita» usa quota o crediti offerti da un provider di modelli esterno, la cui disponibilità, i limiti, i termini sui dati e il catalogo dei modelli possono cambiare in modo indipendente da AX Code.

Percorso supportato più breve: Groq

Groq è un provider predefinito di AX Code, il suo catalogo attuale di modelli AX Code contiene modelli capaci di strumenti, e Groq pubblica i limiti del Free Plan per quegli ID di modello.

1. Crea un account Groq e una chiave API nella console Groq.
2. Memorizza la chiave in AX Code:

ax-code providers login groq

3. Conferma i modelli disponibili nel rilascio di AX Code installato:

ax-code models groq

4. Apri ax-code, esegui /connect e scegli Groq e uno dei modelli elencati. Per una prova senza interfaccia, il catalogo incluso attuale supporta:

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

Se quel modello esatto non è stampato da ax-code models groq, usa un ID di modello che lo sia. Il catalogo installato fa fede per il rilascio installato.

Opzioni integrate di livello gratuito e di credito gratuito

Questi provider sono nel selettore di configurazione predefinito di AX Code. «Integrato» significa che AX Code fornisce l’adattatore di protocollo, i metadati del modello, il flusso delle credenziali e l’endpoint del provider; non significa che ogni modello o richiesta sia gratuito.

Per UnoRouter, collega con ax-code providers login unorouter, esegui ax-code models unorouter e scegli un modello il cui ID finisce con :free. Non dare per scontato che il gemello a pagamento senza quel suffisso sia gratuito. Le note del catalogo di UnoRouter dicono che non ogni modello gratuito supporta le chiamate di strumenti; AX Code mostra solo le voci capaci di strumenti nel catalogo incluso.

Per Google o Hugging Face, collega con l’ID del provider corrispondente e poi usa ax-code models google o ax-code models huggingface. Controlla la pagina dei prezzi viva del provider prima di scegliere un modello.

Aggiungere il router dei modelli gratuiti di OpenRouter

OpenRouter documenta openrouter/free come un router a costo zero che seleziona un modello gratuito disponibile compatibile con la richiesta. Poiché quel router non è nell’istantanea curata attuale di AX Code, aggiungi una voce di modello locale conservativa al ax-code.json nella radice del progetto (oppure uniscila alla configurazione globale di AX Code):

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

I limiti sopra sono valori conservativi di budget di AX Code, non un diritto di OpenRouter. Poi collega e verifica il catalogo di modelli unito:

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

Il openrouter ripetuto è intenzionale: il primo segmento è l’ID del provider di AX Code e openrouter/free è l’ID di modello atteso da OpenRouter. Disponibilità e selezione del router gratuito variano per richiesta; vedi la documentazione del router gratuito di OpenRouter.

Come usare il catalogo esterno di API gratuite

awesome-free-llm-apis è utile per scoprire le offerte attuali, ma non è un elenco di compatibilità né di endorsement di AX Code:

• Un provider in Provider e modelli supportati ha un preset di configurazione predefinito di AX Code.
• Un provider presente solo in models-snapshot.json è sostenuto dal registry, non necessariamente curato per il flusso di configurazione predefinito.
• Un altro servizio può funzionare tramite Provider personalizzati e gateway quando espone un endpoint compatibile con OpenAI o Anthropic.
• «Compatibile con OpenAI» è necessario ma non sufficiente per un agente di programmazione. Il modello selezionato deve anche avere risposte di testo in streaming e chiamate di strumenti o funzioni affidabili.
• Nomi dei provider, ID dei modelli, quote gratuite, regioni e requisiti di account negli elenchi di terze parti possono diventare stantii. Verificali sulle pagine ufficiali di prezzi, modelli e limiti di frequenza del provider prima di farvi affidamento.

Alla data di revisione di questa pagina, i servizi nominati da quel catalogo si mappano su AX Code così:

In particolare, il preset github-copilot non è l’API github-models elencata da alcuni cataloghi. Non sostituire un ID di provider o un flusso di credenziali con l’altro. Le API generali zai e zhipuai partono da GLM-5.3; le SKU più vecchie GLM 3, GLM 4, GLM-5 e GLM-5.2 restano filtrate.

Pratiche di valutazione sicure

• Prova prima con un repository pubblico o usa e getta. Un provider o un gateway ospitato riceve i prompt e il contesto di codice inviati alla sua API.
• Attiva l’isolamento workspace-write, oppure usa read-only per una prova solo di revisione.
• Parti con un compito breve e un solo agente. Council, arena, sessioni lunghe e repository grandi possono consumare molte richieste e colpire in fretta i limiti del livello gratuito.
• Memorizza le credenziali con ax-code providers login o una variabile di ambiente; non committare mai le chiavi API in ax-code.json.
• Tratta 429 e l’indisponibilità temporanea come vincoli normali del livello gratuito. Attendi la finestra di nuovo tentativo del provider oppure scegli un altro modello gratuito attualmente elencato.