Kling 4.0 ONLINE — Video incredibilmente reale | Provalo →
Setup agent

Connetti Factory Droid alla WaveSpeed LLM API

Copia il setup ~/.factory/settings.json consigliato per Factory Droid, instrada le richieste a /v1/chat/completions e verifica le chiamate agent locali in WaveSpeed Logs.

Agente di programmazione di Factory; aggiungi WaveSpeed come modello personalizzato.

File di configurazione

~/.factory/settings.json

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Configurazione manuale

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in~/.factory/settings.json

4

Esegui droid exec e controlla Logs

Chat completions compatibili con OpenAI

L’utilizzo appare in Dashboard e Logs

Cambia modello senza riscrivere il codice dell’agent

Configurazione con un solo comando

Configura Factory Droid, verifica che funzioni ed esegue un backup delle impostazioni precedenti. Aggiungi --undo per ripristinarle.

  1. 1

    Installa la CLI di WaveSpeed

    npm install -g @wavespeed/cli
  2. 2

    Accedi

    wavespeed login
  3. 3

    Configura Factory Droid

    wavespeed setup droid

Non hai Node.js? Vedi le altre opzioni di installazione

Configurazione manuale

Modifica ~/.factory/settings.json
// File: ~/.factory/settings.json  (add to the existing "customModels" array if you already have one)
{
  "customModels": [
    {
      "model": "deepseek/deepseek-v4.1-flash-1017",
      "displayName": "WaveSpeed deepseek/deepseek-v4.1-flash-1017",
      "baseUrl": "https://llm.wavespeed.ai/v1",
      "apiKey": "${WAVESPEED_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16000
    }
  ],
  "sessionDefaultSettings": { "model": "custom:deepseek/deepseek-v4.1-flash-1017" }
}

Non sostituire il nome della variabile

WAVESPEED_API_KEY è il nome della variabile d’ambiente letta dall’agent. Mantieni questo nome nel file di configurazione e inserisci la vera API key nella shell.

1

Temporaneo per questo terminale

Funziona finché non chiudi questa finestra del terminale.

export WAVESPEED_API_KEY="wsk_live_..."
2

Mantieni dopo il riavvio

Scrive la key nel profilo shell così i nuovi terminali possono leggerla.

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

Guida integrazione agent

Usa Factory Droid con la WaveSpeed LLM API

Questa guida mostra come collegare Factory Droid a WaveSpeed AI con ~/.factory/settings.json, Chat completions compatibili con OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 e modello predefinito deepseek/deepseek-v4.1-flash-1017. Copia la configurazione sopra, esporta la tua API key, avvia l’agent e verifica le richieste in Logs.

1

Crea una chiave di accesso WaveSpeed

2

Esporta localmente la chiave richiesta

3

Incolla la configurazione in

~/.factory/settings.json
4

Esegui droid exec e controlla Logs

Cosa configura questo setup di Factory Droid

Protocollo

Chat completions compatibili con OpenAI

Endpoint

/v1/chat/completions

Modello

deepseek/deepseek-v4.1-flash-1017

La configurazione pronta da copiare sopra è l’unico file Factory Droid da modificare per il setup consigliato: ~/.factory/settings.json. Mantieni la API key nell’ambiente shell per non committarla in un repository.

Risoluzione problemi

La API key non viene letta

Esporta WAVESPEED_API_KEY nella stessa shell in cui esegui Factory Droid. Se usi un profilo shell, ricarica il terminale prima di avviare l’agent.

Le richieste falliscono con errore di protocollo o endpoint

Controlla che Factory Droid usi Chat completions compatibili con OpenAI ed endpoint /v1/chat/completions. Le discrepanze di protocollo sono la causa più comune di errori 404 o payload.

Il modello selezionato non funziona

Conferma che l’ID modello esista in WaveSpeed Models, poi incolla l’ID esatto in ~/.factory/settings.json. Puoi iniziare dal modello predefinito mostrato in questa pagina.

In Logs non appare alcuna richiesta

Assicurati che Factory Droid usi la base URL WaveSpeed e la tua API key attuale. Poi invia un nuovo prompt dall’agent locale e aggiorna Logs.

Questa guida Factory Droid può apparire nei motori di ricerca?

Sì. Questa pagina è costruita come guida di setup indicizzabile per utenti che cercano Factory Droid custom provider, endpoint compatibile OpenAI, base URL e workflow di configurazione agent locale.