BroadRouter

Usare Aider con DeepSeek V4.1 Flash illimitato

Aggiornato

Aider si collega a qualsiasi API compatibile con OpenAI. Imposta OPENAI_API_BASE su https://inference.broadnet.ai/v1 e OPENAI_API_KEY con la tua chiave BroadNet, poi lancia aider --model openai/broadnet/deepseek-v4.1-flash. Il prefisso openai/ seleziona il percorso compatibile con OpenAI di Aider. Con la chiave di un piano illimitato i token di DeepSeek V4.1 Flash non vengono contati, quindi anche le sessioni lunghe su un repository restano a prezzo fisso.

Gli agenti di coding rimandano grandi parti del repository a ogni turno, quindi con la fatturazione per token il conto sale in fretta. Una sessione con piano illimitato elimina il contatore. I passaggi seguono la configurazione compatibile con OpenAI di Aider.

1. Installa Aider

python -m pip install aider-install
aider-install

2. Puntalo su BroadNet Inference

export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY='your-broadnet-plan-key'

Su Windows usa setx OPENAI_API_BASE https://inference.broadnet.ai/v1 e setx OPENAI_API_KEY your-key, poi apri un nuovo terminale. La documentazione di Aider dice di riavviare la shell dopo setx.

Lascia il /v1 alla fine del base URL: il percorso di chat completions lo aggiunge Aider.

3. Avvialo sul tuo codice

cd /path/to/your/project
aider --model openai/broadnet/deepseek-v4.1-flash

Il prefisso openai/ dice ad Aider di usare l’endpoint compatibile con OpenAI; il resto è l’ID del modello su BroadNet. Aider mostrerà l’avviso “Unknown context window size and costs, using sane defaults.” (traduzione: «Dimensione della finestra di contesto e costi sconosciuti, uso valori predefiniti ragionevoli.»). È normale per i modelli fuori dal suo elenco integrato. La sua pagina sugli avvisi dei modelli dice che di solito si può ignorare.

4. Facoltativo: descrivi il modello ad Aider

Per togliere l’avviso e lasciare al modello spazio per ragionare, aggiungi due file nella tua home o nella radice del repository. Aider li legge da entrambe le posizioni, come spiega la documentazione sulle impostazioni avanzate dei modelli.

.aider.model.metadata.json:

{
  "openai/broadnet/deepseek-v4.1-flash": {
    "max_input_tokens": 1048576,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

.aider.model.settings.yml:

- name: openai/broadnet/deepseek-v4.1-flash
  edit_format: diff
  extra_params:
    max_tokens: 16000

Per i modelli sconosciuti Aider usa il formato di modifica whole, che rimanda i file interi. diff invia solo i blocchi modificati. Se le modifiche non si applicano, togli la riga edit_format per tornare a whole.

Consigli

  • Una finestra di Aider, una sessione. Se fai girare due istanze di Aider contemporaneamente, acquista due sessioni, altrimenti si mettono in coda una dietro l’altra.
  • Il ragionamento consuma token. DeepSeek V4.1 Flash ragiona prima di rispondere, e BroadNet lo conta in max_tokens. Perché le risposte arrivano vuote.
  • Prova prima un’ora. Un piano Meteor costa $1 per un’ora, abbastanza per valutarlo su un task reale.

Risoluzione dei problemi

  • 401 Unauthorized. OPENAI_API_KEY manca, è sbagliata o scaduta. Controlla che la shell in cui gira Aider abbia la variabile; su Windows apri un nuovo terminale dopo setx.
  • Le richieste vanno a OpenAI invece che a BroadNet. OPENAI_API_BASE non è impostata in questa shell, oppure il nome del modello non ha il prefisso openai/. Controlla con echo $OPENAI_API_BASE.
  • Modello non trovato. La parte dopo openai/ deve essere esattamente broadnet/deepseek-v4.1-flash. Una chiave di piano copre solo DeepSeek V4.1 Flash; gli altri modelli BroadNet richiedono una chiave a consumo.
  • Risposte vuote o troncate. Alza max_tokens in .aider.model.settings.yml come mostrato sopra.
  • Le modifiche non si applicano. Riporta edit_format a whole, oppure prova --edit-format whole da riga di comando.
  • Risposte lente o 429. Una sessione del piano esegue una richiesta alla volta; una seconda finestra di Aider finisce in coda. Una chiave a consumo consente 30 richieste al minuto e 4 contemporaneamente. Vedi errori e retry.

Preferisci un agente dentro VS Code? Vedi la guida alla configurazione di Cline, oppure confrontali in Cline vs Roo Code vs Aider.

Scegli un piano su BroadNet Inference

Domande frequenti

Come si usa Aider con un’API compatibile con OpenAI?

Imposta OPENAI_API_BASE sul base URL del provider e OPENAI_API_KEY con la sua chiave, poi avvia aider con --model openai/ seguito dall’ID del modello del provider. Per BroadNet è openai/broadnet/deepseek-v4.1-flash, con base URL https://inference.broadnet.ai/v1.

Perché Aider dice "Unknown context window size and costs"?

Aider non ha metadati integrati per gli ID dei modelli BroadNet, quindi presume un contesto illimitato e costo zero. Secondo la documentazione di Aider, di solito l’avviso si può ignorare. Per toglierlo, aggiungi il modello a .aider.model.metadata.json.

Serve il prefisso openai/ se l’ID del modello inizia già con broadnet/?

Sì. Aider legge la prima parte come percorso del provider: openai/ manda la richiesta a OPENAI_API_BASE, e broadnet/deepseek-v4.1-flash è l’ID del modello che riceve BroadNet.

Perché Aider riceve risposte vuote o troncate da DeepSeek V4.1 Flash?

Il modello ragiona prima di rispondere, e BroadNet conta il ragionamento in max_tokens. Imposta un max_tokens più alto tramite extra_params in .aider.model.settings.yml.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity