Seedream 5.0 Pro 正式上線 | 在圖片生成器中體驗 →
Agent 設定

將 OpenCode 接入 WaveSpeed LLM API

複製推薦的 ~/.config/opencode/opencode.json 設定,將 OpenCode 請求路由到 /v1/chat/completions,並在 WaveSpeed Logs 中驗證本機 agent 呼叫。

設定檔

~/.config/opencode/opencode.json

協定

OpenAI 相容 Chat Completions

Endpoint

/v1/chat/completions

快速開始

1

建立 WaveSpeed Access Key

2

在本機匯出所需金鑰

3

將設定貼到~/.config/opencode/opencode.json

4

執行 opencode 並查看 Logs

OpenAI 相容 Chat Completions

用量會顯示在 Dashboard 和 Logs 中

不用改 Agent 程式碼即可切換模型

編輯 ~/.config/opencode/opencode.json
// File: ~/.config/opencode/opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "wavespeed": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "WaveSpeed AI",
      "options": {
        "baseURL": "https://llm.wavespeed.ai/v1",
        "apiKey": "{env:WAVESPEED_API_KEY}"
      },
      "models": {
        "deepseek/deepseek-v4-flash": {
          "name": "deepseek/deepseek-v4-flash",
          "tool_call": true
        }
      }
    }
  },
  "model": "wavespeed/deepseek/deepseek-v4-flash"
}

不要替換變數名稱

WAVESPEED_API_KEY 是 Agent 讀取的環境變數名稱。設定檔中請保持這個名稱不變,真實 API key 放到你的 shell 環境變數中。

1

僅目前終端機生效

關閉這個終端機視窗後會失效,適合臨時測試。

export WAVESPEED_API_KEY="wsk_live_..."
2

重啟後仍然生效

寫入 shell 設定檔,之後新開的終端機也能讀取。

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

Agent 接入指南

將 OpenCode 接入 WaveSpeed LLM API

本指南說明如何透過 ~/.config/opencode/opencode.json、OpenAI 相容 Chat Completions、/v1/chat/completions、base URL https://llm.wavespeed.ai/v1 和預設模型 deepseek/deepseek-v4-flash 將 OpenCode 接入 WaveSpeed AI。複製上方設定,匯出 API key,執行 agent,然後在 Logs 中驗證請求。

1

建立 WaveSpeed Access Key

2

在本機匯出所需金鑰

3

將設定貼到

~/.config/opencode/opencode.json
4

執行 opencode 並查看 Logs

這個 OpenCode 設定會配置什麼

協定

OpenAI 相容 Chat Completions

Endpoint

/v1/chat/completions

模型

deepseek/deepseek-v4-flash

上方可複製設定就是推薦方案下唯一需要編輯的 OpenCode 檔案:~/.config/opencode/opencode.json。API key 建議保留在 shell 環境變數中,避免提交到程式碼倉庫。

常見問題排查

API key 沒有生效

請在運行 OpenCode 的同一個 shell 中導出 WAVESPEED_API_KEY。如果寫入 shell profile,需要重新加載終端後再啟動 agent。

請求出現協議或 endpoint 錯誤

確認 OpenCode 使用的是 OpenAI 相容 Chat Completions 和 endpoint /v1/chat/completions。協議不匹配是 404 或 payload 錯誤最常見的原因。

選擇的模型不可用

先確認模型 ID 存在於 WaveSpeed Models,再將完整 ID 粘貼到 ~/.config/opencode/opencode.json。也可以先使用本頁展示的默認模型。

Logs 中沒有請求記錄

確認 OpenCode 使用的是 WaveSpeed base URL 和當前 API key。然後從本地 agent 發送一個新 prompt,並刷新 Logs。

這個 OpenCode 指南可以被搜尋到嗎?

可以。這個頁面設計成可索引的接入指南,用來承接搜尋 OpenCode custom provider、OpenAI-compatible endpoint、base URL 和本機 agent 設定流程的使用者。

將 OpenCode 接入 WaveSpeed LLM API