OpenCat, ChatBox, LobeChat에 WaveSpeed LLM 설정하기: 앱 하나로 290개 이상의 모델 사용
OpenCat, ChatBox, LobeChat에 WaveSpeed LLM을 설정하는 단계별 가이드. Endpoint, API Key, Chat Protocol 필드에 입력할 내용을 정확히 안내합니다 — 추측 없이.
모든 채팅 앱이 묻는 세 가지 항목
OpenCat, ChatBox, LobeChat, ChatGPT Next Web, Cherry Studio 등 최신 데스크톱/모바일 LLM 채팅 앱들은 커스텀 제공자를 추가할 때 동일한 세 가지 항목을 입력하도록 요구합니다:
- 엔드포인트 (“API Host”, “Base URL”, “Server URL”이라고도 함)
- API 키 (“Secret Key”, “SK”, “Token”이라고도 함)
- 채팅 프로토콜 (“API Type” 또는 “Compatible Mode”라고도 함)
대부분의 사람들은 이 세 항목에서 설정이 막힙니다. 이 가이드는 WaveSpeed LLM을 백엔드로 사용하여 OpenCat, ChatBox, LobeChat — 가장 인기 있는 세 가지 채팅 앱에 정확히 무엇을 입력해야 하는지 알려줍니다.
공통 답변
어떤 채팅 앱을 설정하든 WaveSpeed LLM에 대한 답변은 항상 동일합니다:
| 항목 | 값 |
|---|---|
| 엔드포인트 / Base URL | https://llm.wavespeed.ai/v1 |
| API 키 | WaveSpeed API 키 (대시보드에서 확인) |
| 채팅 프로토콜 | OpenAI (Chat Completions) |
| 모델 ID | vendor/model — 예: anthropic/claude-opus-4.6 |
이 네 가지 값으로 OpenAI 호환 클라이언트라면 무엇이든 연결할 수 있습니다. 아래에서 세 가지 특정 앱을 안내합니다.
사전 준비: WaveSpeed API 키 발급
- wavespeed.ai에 접속하여 로그인합니다.
- Dashboard → API Keys를 엽니다.
- 새 키를 생성하고 즉시 복사하여 안전하게 보관합니다.
이 탭을 열어두세요 — 아래 각 앱에 키를 붙여넣을 것입니다.
OpenCat
OpenCat은 macOS와 iOS에서 인기 있는 네이티브 채팅 클라이언트입니다.
- OpenCat → Settings → API Providers → Add Provider를 엽니다 (또는 기존 OpenAI 제공자를 편집합니다).
- 입력:
- Name: WaveSpeed LLM (원하는 이름)
- API Host:
https://llm.wavespeed.ai/v1 - API Key:
YOUR_WAVESPEED_API_KEY - Protocol / Provider Type: OpenAI
- 저장합니다. OpenCat이 사용 가능한 모델을 나열합니다 —
anthropic/claude-opus-4.6또는 WaveSpeed 카탈로그의 다른 모델을 선택합니다. - OpenCat이 모델을 자동으로 나열하지 않으면 ID
anthropic/claude-opus-4.6으로 수동으로 추가합니다.
팁: OpenCat에서는 서로 다른 모델로 여러 어시스턴트를 만들 수 있습니다. 각각 다른 WaveSpeed 모델 ID를 지정하여 Claude, GPT, Gemini를 나란히 비교해 보세요.
ChatBox
ChatBox는 크로스 플랫폼(Windows, macOS, Linux, 모바일) 채팅 앱입니다.
- ChatBox → Settings → Model을 엽니다.
- 설정:
- Model Provider: OpenAI API (또는 “Custom OpenAI”)
- API Key:
YOUR_WAVESPEED_API_KEY - API Host:
https://llm.wavespeed.ai/v1 - API Path:
/chat/completions(기본값, 그대로 유지) - Model:
anthropic/claude-opus-4.6(목록에 없으면 직접 입력)
- 저장하고 새 채팅을 시작합니다.
ChatBox는 제공자별로 모델 목록을 캐시합니다. 모델이 표시되지 않으면 모델 ID를 수동으로 입력하세요 — ChatBox가 해당 ID를 사용합니다.
LobeChat
LobeChat은 자체 호스팅 또는 lobehub.com을 통해 사용 가능한 완전한 기능의 오픈소스 채팅 UI입니다.
- LobeChat → Settings → Language Model → OpenAI를 엽니다.
- Enable 토글을 켭니다.
- 입력:
- API Key:
YOUR_WAVESPEED_API_KEY - API Proxy Address (또는 Base URL):
https://llm.wavespeed.ai/v1
- API Key:
- Model List 아래에서 커스텀 모델을 추가합니다:
- 모델 ID:
anthropic/claude-opus-4.6 - 표시 이름: 원하는 이름
- 모델 ID:
- 저장하고 대화에서 새 모델을 선택합니다.
WaveSpeed를 통해 Claude나 Gemini를 호출할 때도 LobeChat의 OpenAI 제공자를 선택하는 것이 올바릅니다 — 클라이언트는 OpenAI Chat Completions로 통신하고 WaveSpeed가 업스트림 모델로 투명하게 라우팅합니다.
”OpenAI”가 항상 올바른 프로토콜인 이유
자주 있는 혼동: WaveSpeed를 통해 Claude를 호출한다면 프로토콜로 “Anthropic”을 선택해야 하지 않을까요?
아닙니다. OpenAI를 선택하세요.
WaveSpeed LLM은 Claude, GPT, Gemini, Llama, Qwen, DeepSeek 등 모든 모델을 OpenAI Chat Completions 프로토콜을 통해 제공합니다. 모델 ID의 anthropic/ 접두사는 WaveSpeed에게 어떤 업스트림 모델로 라우팅할지 알려주는 것입니다. 채팅 앱은 OpenAI 방식으로만 통신하면 됩니다.
이것이 통합 OpenAI 호환 게이트웨이의 핵심입니다: 사용하는 도구가 차이를 알 필요가 없습니다.
사용해 볼 인기 모델 ID
| 모델 ID | 참고 |
|---|---|
anthropic/claude-opus-4.6 | 1M 컨텍스트 Claude |
anthropic/claude-sonnet-4.6 | 더 빠르고 저렴한 Claude |
openai/gpt-5.2-pro | 최고 수준의 OpenAI 추론 |
openai/gpt-5.2-chat | 균형 잡힌 GPT |
google/gemini-3-flash-preview | 빠른 멀티모달 |
deepseek/deepseek-v4 | 가장 저렴한 고성능 코더 |
meta-llama/llama-4-70b | 오픈 웨이트, 안정적 |
전체 카탈로그는 wavespeed.ai/llm에서 확인하세요.
문제 해결
“Invalid API Key” / 401 Unauthorized 잘못된 키를 붙여넣었습니다. WaveSpeed 대시보드에서 키를 정확히 복사하세요 — 앞뒤 공백이 없어야 합니다.
“Model not found” / 404
모델 ID는 반드시 vendor/model 형식의 전체 이름을 사용해야 합니다. 클라이언트가 claude-opus-4.6처럼 축약된 형식으로 자동완성하면 수동으로 수정하세요.
앱이 api.openai.com에 연결을 시도함
Base URL / API Host를 변경하는 것을 잊었습니다. 설정을 다시 열고 https://llm.wavespeed.ai/v1으로 되어 있는지 확인하세요.
SSL / 인증서 오류
채팅 앱을 최신 버전으로 업데이트하세요. 최신 버전은 모두 llm.wavespeed.ai에 대한 표준 TLS 연결을 지원합니다.
하나의 키, 여러 앱
사용하는 모든 채팅 클라이언트에 동일한 WaveSpeed API 키를 추가하세요. 하나의 계정, 하나의 청구서, 290개 이상의 모델을 어디서나 사용할 수 있습니다.
WaveSpeed API 키 발급받기 — 몇 분 안에 원하는 채팅 앱에 연결해 보세요.
