WaveSpeedAI
← 블로그

WaveSpeed LLM API 빠른 시작: 엔드포인트, API 키, OpenAI 호환 설정

WaveSpeed LLM을 처음 사용하는 사람들이 묻는 세 가지 질문: 어떤 엔드포인트를 사용하나요? API 키는 무엇인가요? 어떤 프로토콜을 사용하나요? 이 가이드는 Python, Node.js, curl을 위한 복사-붙여넣기 코드와 함께 세 가지 질문 모두에 답합니다.

4 min read
WaveSpeed LLM API 빠른 시작: 엔드포인트, API 키, OpenAI 호환 설정

WaveSpeedAI에서 290개 이상의 LLM을 탐색하세요 — Claude, GPT, Gemini, Qwen, DeepSeek, Llama, Grok, Mistral 등 하나의 OpenAI 호환 엔드포인트로 이용 가능합니다. LLM 카탈로그 → · 플레이그라운드 →

입력해야 할 세 가지 필드

새로운 LLM 제공자를 채팅 앱, SDK 또는 IDE에 연결할 때 거의 항상 동일한 세 가지 정보를 요청받습니다:

  1. 엔드포인트 / 기본 URL — API가 위치한 곳.
  2. API 키 — 제공자가 사용자를 식별하는 방법.
  3. 채팅 프로토콜 — OpenAI Chat Completions, Anthropic Messages 또는 기타.

WaveSpeed LLM의 경우 답은 간단합니다:

필드값
기본 URLhttps://llm.wavespeed.ai/v1
API 키WaveSpeed API 키 (대시보드에서 발급)
프로토콜OpenAI Chat Completions (OpenAI SDK와 드롭인 호환)

이게 전부입니다. 도구가 “사용자 지정 OpenAI 호환 엔드포인트”를 지원한다면 WaveSpeed LLM이 작동합니다.

WaveSpeed LLM이란?

WaveSpeed LLM은 단일 OpenAI 호환 엔드포인트를 통해 30개 이상의 제공자에서 290개 이상의 언어 모델에 접근할 수 있는 통합 API입니다 — Claude Opus 4.6, GPT-5.2, Gemini 3, DeepSeek, Llama 4, Qwen 3, Grok 4, Mistral 등. 하나의 API 키, 하나의 기본 URL, 하나의 요청 형식.

콜드 스타트 없음. 토큰당 과금. 구독 없음. 무료 티어로 시작 가능.

1단계: API 키 발급

  1. wavespeed.ai에 접속하여 로그인합니다 (Google/이메일).
  2. 대시보드를 열고 API 키 섹션을 찾습니다.
  3. 새 키를 생성합니다 — 긴 무작위 문자열처럼 생겼습니다. 즉시 복사하여 비밀로 저장하세요.

이 키를 비밀번호처럼 취급하세요. git에 커밋하거나 스크린샷에 붙여넣지 마세요.

2단계: 기본 URL 설정

LLM API는 다음 위치에 있습니다:

https://llm.wavespeed.ai/v1

Chat Completions 엔드포인트는 따라서:

https://llm.wavespeed.ai/v1/chat/completions

도구에서 “OpenAI 기본 URL”, “API 엔드포인트” 또는 “사용자 지정 서버 URL”을 요청하는 곳 어디서나 https://llm.wavespeed.ai/v1을 붙여넣으세요.

3단계: 모델 선택

모델 ID는 vendor/model 형식을 사용합니다. 인기 있는 몇 가지 모델:

모델 ID비고
anthropic/claude-opus-4.6100만 컨텍스트, 비전 + 툴 사용
openai/gpt-5.2-pro40만 컨텍스트, 최고 수준의 OpenAI 추론
google/gemini-3-flash-preview빠름, 멀티모달
deepseek/deepseek-v4오픈 가중치, 강력한 코딩 능력
meta-llama/llama-4-70b오픈, 저렴, 안정적

전체 카탈로그는 wavespeed.ai/llm에서 확인하세요.

4단계: 첫 번째 호출 실행

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://llm.wavespeed.ai/v1"
)

response = client.chat.completions.create(
    model="anthropic/claude-opus-4.6",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

Node.js (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://llm.wavespeed.ai/v1'
});

const response = await client.chat.completions.create({
  model: 'anthropic/claude-opus-4.6',
  messages: [{ role: 'user', content: 'Hello!' }]
});

console.log(response.choices[0].message.content);

curl

curl https://llm.wavespeed.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "anthropic/claude-opus-4.6",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

OpenAI를 직접 호출하는 것과의 차이점은 단 두 가지뿐입니다: base_url과 model 문자열. 기존 OpenAI 코드는 그 외에는 변경 없이 작동합니다.

스트리밍, 툴, 비전

OpenAI의 Chat Completions 엔드포인트에서 사용하는 모든 기능이 WaveSpeed LLM에서 작동합니다:

  • 서버-전송 이벤트 스트리밍을 위한 stream: true.
  • 함수 호출을 위한 tools 및 tool_choice (지원하는 모델에서).
  • JSON 모드를 위한 response_format: { type: "json_object" }.
  • 비전 지원 모델에서 content: [{ type: "image_url", image_url: { url: "..." } }]를 통한 이미지 입력.

프로토콜이 동일하기 때문에 OpenAI를 기반으로 구축된 모든 라이브러리나 프레임워크 — LangChain, LlamaIndex, Vercel AI SDK, Haystack — 는 기본 URL만 교체하면 작동합니다.

문제 해결

“Invalid API key” / 401 오류 WaveSpeed 대시보드의 API 키를 사용하고 있는지 확인하세요. OpenAI 또는 다른 제공자의 키가 아니어야 합니다. 헤더는 반드시 Authorization: Bearer <key> 형식이어야 합니다.

“Model not found” / 모델 404 오류 모델 ID는 대소문자를 구분하며 반드시 벤더 접두사를 포함해야 합니다. anthropic/claude-opus-4.6을 사용하세요. claude-opus-4.6이나 Claude-Opus-4.6은 사용하지 마세요.

“Wrong protocol” 도구에서 “OpenAI”, “Anthropic”, “Gemini” 등 중 선택하라고 하면 항상 OpenAI를 선택하세요. WaveSpeed LLM은 Claude와 Gemini 모델을 포함한 모든 모델에 대해 OpenAI Chat Completions 형식을 사용합니다. 모델 ID의 벤더 접두사가 업스트림 모델을 선택하며, 요청 형식은 OpenAI 호환으로 유지됩니다.

네트워크 / 연결 문제 엔드포인트는 https://llm.wavespeed.ai/v1입니다 — llm. 서브도메인을 확인하세요 (api.가 아닙니다). 방화벽이 사용자 지정 서브도메인을 차단하는 경우 llm.wavespeed.ai를 허용 목록에 추가하세요.

WaveSpeed LLM을 선택하는 이유

  • 하나의 통합으로 290개 이상의 모델. 코드 한 줄 변경 없이 anthropic/claude-opus-4.6을 openai/gpt-5.2-pro로 교체하세요.
  • OpenAI 호환. 모든 OpenAI SDK, LangChain, Vercel AI SDK, 사용자 지정 기본 URL을 허용하는 모든 도구와 작동합니다.
  • 콜드 스타트 없음, 구독 없음. 사용한 만큼만 지불하고, 투명한 토큰당 요금제.
  • 무료 티어. 신용카드 없이 개발을 시작하세요.

지금 바로 시작하세요

세 가지 필드 — 기본 URL, API 키, OpenAI 프로토콜 — 만 있으면 준비 완료입니다.

wavespeed.ai/llm에서 API 키를 발급받으세요 그리고 5분 이내에 첫 번째 호출을 실행해 보세요.

공유