Which config file does Factory Droid use?

Use ~/.factory/settings.json for the recommended WaveSpeed AI setup. The configuration points Factory Droid to endpoint /v1/chat/completions.

Which protocol should Factory Droid use?

Factory Droid should use OpenAI-compatible chat completions. This page uses endpoint /v1/chat/completions to match that protocol.

How do I verify Factory Droid is connected?

Run Factory Droid locally and open WaveSpeed Logs. Successful requests should appear with the selected model and usage details.

Agent Setup

Connect Factory Droid to WaveSpeed LLM API

Copy the recommended ~/.factory/settings.json setup for Factory Droid, route requests to /v1/chat/completions, and verify local agent calls in WaveSpeed Logs.

API Key Test Model

Factory's coding agent; add WaveSpeed as a custom model.

Config file

~/.factory/settings.json

Protocol

OpenAI-compatible chat completions

Endpoint

/v1/chat/completions

Manual setup

Create a WaveSpeed access key

Export the required key locally

Paste config into~/.factory/settings.json

Run droid exec and check Logs

Model

OpenAI-compatible chat completions

Usage appears in Dashboard and Logs

Switch models without rewriting agent code

One-command setup

Configures Factory Droid, checks that it works, and backs up your previous settings. Add --undo to restore them.

1
Install the WaveSpeed CLI
npm install -g @wavespeed/cli
2
Sign in
wavespeed login
3
Configure Factory Droid
wavespeed setup droid

No Node.js? See other install options

Manual setup

Edit ~/.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" }
}

Do not replace the variable name

WAVESPEED_API_KEY is the environment variable name that the agent reads. Keep this name in the config file, and put your real API key in your shell instead.

Temporary for this terminal

Works until you close this terminal window.

export WAVESPEED_API_KEY="wsk_live_..."

Keep it after restart

Writes the key into your shell profile so new terminals can read it.

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

Use Factory Droid with WaveSpeed LLM API

This guide shows how to connect Factory Droid to WaveSpeed AI with ~/.factory/settings.json, OpenAI-compatible chat completions, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1, and default model deepseek/deepseek-v4.1-flash-1017. Copy the configuration above, export your API key, run the agent, then verify requests in Logs.

Connect Factory Droid to WaveSpeed LLM API

Manual setup

Use Factory Droid with WaveSpeed LLM API

What this Factory Droid setup configures

Troubleshooting

Can this Factory Droid guide show up in search?