WaveSpeed CLI · MCP
Claude Code, Codex, 터미널에서 이미지와 동영상 생성
모든 WaveSpeed AI 모델을 실행하는 단일 오픈소스 CLI. 이미지, 비디오, 오디오, 3D. Codex, Claude Code, Claude Cowork, Cursor 같은 터미널과 코딩 에이전트를 위해 설계되었습니다.
CLI
@wavespeed/cli
한 번 설치하면 셸이나 스크립트에서 어떤 모델이든 실행할 수 있습니다.
$npm install -g @wavespeed/cliMCP
@wavespeed/mcp
호스팅 MCP 서버: 어떤 MCP 클라이언트에서든 주소를 추가하고 로그인하세요.
https://api.wavespeed.ai/mcp에이전트에 WaveSpeed 설정하기
사용하는 도구를 고르면 가장 빠른 설정 방법을 보여 드립니다. 어떤 방법이든 전체 모델 카탈로그를 쓰고, 실행 전에 가격을 확인할 수 있습니다.
Claude Code
플러그인호스팅 MCP 서버와 WaveSpeed 스킬을 한 번에 설치합니다.
- 1
WaveSpeed 마켓플레이스 추가
$claude plugin marketplace add WaveSpeedAI/claude-plugins - 2
플러그인 설치
$claude plugin install wavespeed@wavespeed - 3
Claude Code에서 /mcp를 실행하고 wavespeed를 선택한 뒤 브라우저에서 연결을 승인
/mcp
다른 방법
스킬 없이 MCP 서버만 쓰려면:
$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcpCodex
플러그인호스팅 MCP 서버와 WaveSpeed 스킬을 한 번에 설치합니다.
- 1
WaveSpeed 마켓플레이스 추가
$codex plugin marketplace add WaveSpeedAI/codex-plugins - 2
Codex에서 /plugins를 열고 WaveSpeed를 설치한 뒤 브라우저에서 연결을 승인
/plugins
다른 방법
스킬 없이 MCP 서버만 쓰려면:
$codex mcp add wavespeed --url https://api.wavespeed.ai/mcp && codex mcp login wavespeedOpenCode
플러그인호스팅 MCP 서버와 WaveSpeed 스킬을 한 번에 설치합니다.
- 1
opencode.json에 플러그인 추가
{ "plugin": ["@wavespeed/opencode"] } - 2
로그인하고 브라우저에서 연결을 승인
$opencode mcp auth wavespeed
다른 방법
스킬 없이 MCP 서버만 쓰려면:
$opencode mcp add wavespeed --url https://api.wavespeed.ai/mcp && opencode mcp auth wavespeedCursor
원클릭호스팅 MCP 서버에 연결합니다. 설치할 것이 없습니다.
- 1
버튼을 클릭하고 Cursor에서 확인
Cursor에 추가 - 2
요청이 오면 WaveSpeed에 로그인하고 연결을 승인
다른 방법
또는 mcp.json에 다음을 추가:
{
"mcpServers": {
"wavespeed": { "url": "https://api.wavespeed.ai/mcp" }
}
}VS Code
명령어 한 줄호스팅 MCP 서버에 연결합니다. 설치할 것이 없습니다.
- 1
터미널에서 실행
$code --add-mcp '{"name":"wavespeed","type":"http","url":"https://api.wavespeed.ai/mcp"}' - 2
요청이 오면 WaveSpeed에 로그인하고 연결을 승인
다른 방법
서버를 내 컴퓨터에서 실행하려면:
Claude
커스텀 커넥터웹의 Claude와 Claude Desktop에서 모두 작동합니다. 설치할 것이 없습니다.
- 1
Claude에서 Customize → Connectors → Add custom connector 열기
- 2
이 주소 붙여넣기
https://api.wavespeed.ai/mcp - 3
WaveSpeed 계정으로 로그인
다른 방법
서버를 내 컴퓨터에서 실행하려면:
ChatGPT
커스텀 커넥터ChatGPT에 WaveSpeed를 커스텀 MCP 서버로 추가합니다. 설치할 것이 없습니다.
- 1
ChatGPT에서 Plugins를 열고 Add custom MCP server 선택
- 2
끝의 /mcp를 유지한 채 이 주소 붙여넣기
https://api.wavespeed.ai/mcp - 3
OAuth를 선택하고 WaveSpeed 계정으로 로그인
다른 방법
ChatGPT는 내 컴퓨터의 파일을 읽을 수 없습니다. 채팅에 첨부하거나 공개 URL을 전달하세요.
Gemini CLI
확장 프로그램Gemini CLI용 WaveSpeed 스킬 묶음으로, 명령어 하나로 설치하고 업데이트합니다.
- 1
WaveSpeed CLI 설치 후 로그인
$npm install -g @wavespeed/cli && wavespeed login - 2
확장 프로그램 설치
$gemini extensions install https://github.com/WaveSpeedAI/wavespeed-gemini-extension
DeepSeek Harness
스킬 플러그인WaveSpeed 스킬을 자동으로 등록하는 dsh 플러그인입니다.
- 1
WaveSpeed CLI 설치 후 로그인
$npm install -g @wavespeed/cli && wavespeed login - 2
스킬 플러그인 추가
$dsh plugin --profile web add github:WaveSpeedAI/wavespeed-dsh-skill
기타 MCP 클라이언트
호스팅 MCPWindsurf, Cline, GitHub Copilot, Goose 등 모든 MCP 클라이언트: 주소로 호스팅 서버를 추가하세요.
- 1
이 주소로 원격 MCP 서버를 추가하세요. 대부분의 클라이언트는 이어서 브라우저로 로그인하게 합니다.
https://api.wavespeed.ai/mcp
다른 방법
원격 MCP를 지원하지 않는 클라이언트라면 서버를 로컬에서 실행하세요:
{
"mcpServers": {
"wavespeed": {
"command": "npx",
"args": ["-y", "@wavespeed/mcp@latest"],
"env": { "WAVESPEED_API_KEY": "wsk_..." }
}
}
}wavespeed login으로 로그인했다면 로컬 서버가 그 로그인을 사용하므로 env 줄은 지워도 됩니다.
세 가지 명령으로 출시 준비 완료
- 1
설치
Node 18+ 가 필요합니다. 한 번의 글로벌 설치로 wavespeed 바이너리를 어디서든 사용할 수 있습니다.
$npm install -g @wavespeed/cli - 2
로그인
브라우저에서 access-key 페이지가 열립니다. 복사된 키를 자동으로 감지하고 즉시 검증합니다.
$wavespeed login - 3
아무 모델이나 실행
모든 모델이 동일한 형식. 모델 ID 와 입력만 전달하면 CDN URL 이 반환되거나, --json 으로 스크립트에 파이프할 수 있습니다.
$wavespeed run wavespeed-ai/z-image/turbo -p "a cat"
코딩 에이전트에게 CLI 가르치기
스킬을 설치해 Codex, Claude Code, Cursor 등 에이전트가 CLI 호출 방법을 알게 합니다.
$wavespeed skill installNode.js가 없나요?
macOS와 Linux에서는 독립 실행형 파일을 설치할 수 있습니다. Windows에서는 GitHub Releases에서 내려받으세요.
$curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bash항상 최신 상태로
명령어 한 줄로 최신 버전으로 업그레이드합니다.
$wavespeed upgrade코딩 에이전트에서 WaveSpeed 모델 사용하기
Claude Code, Codex, OpenCode 등이 WaveSpeed LLM API를 사용하도록 설정합니다. 언제든 되돌릴 수 있습니다.
$wavespeed setup
사람과 에이전트 모두를 위해 설계
모델별 동적 도움말
wavespeed run <model> -h 를 실행하면 CLI 가 해당 모델의 입력 스키마를 실시간으로 가져와 정확한 플래그를 출력합니다 — 추측할 필요 없음.
저장소와 함께 따라가는 별칭
wavespeed.json 에 모델 + 기본 입력을 묶은 명명된 단축키를 정의하세요. 팀이 파일을 받아 wavespeed run hero 만 입력하면 브랜드에 맞는 결과를 얻습니다.
에이전트 네이티브 설계
모든 명령이 stdout 의 --json 과 stderr 의 진행 상황을 지원합니다. SKILL.md 를 두면 Codex, Claude Code, Claude Cowork, Cursor 가 호출 방법을 압니다.
마법 없음, 데몬 없음
CLI 는 프롬프트를 절대 변경하지 않고 백그라운드 프로세스를 열지 않습니다. api.wavespeed.ai 를 직접 호출합니다. 오픈소스, MIT 라이선스.
실제 세션의 모습
카탈로그 탐색에서 JSON 출력까지 — 세 가지 명령.
# 1. browse the catalog
$ wavespeed models --type text-to-image --popular
# 2. inspect a model's inputs — schema fetched live
$ wavespeed run wavespeed-ai/z-image/turbo -h
* prompt string
size string default: "1024*1024"
strength number default: 0.6 range: 0..1
output_format string default: "jpeg" enum: jpeg | png | webp
# 3. run — JSON out so you can pipe it
$ wavespeed run wavespeed-ai/z-image/turbo \
-p "a cyberpunk skyline at golden hour" --json
{
"model": "wavespeed-ai/z-image/turbo",
"outputs": ["https://example.com/output/skyline.jpeg"],
"elapsed_ms": 4718
}Claude Code와 Codex에서 이미지와 동영상 생성
CLI와 스킬을 한 번 설치하고 그냥 요청하세요. 코딩 에이전트가 명령을 실행하고 파일을 프로젝트에 저장합니다.
우리 카페 랜딩 페이지에 쓸 16:9 히어로 이미지 만들어 줘. 아늑하고, 해 뜨는 분위기에, 헤드라인 넣을 자리도 있게.
/filters:quality(82)/media/images/31fc1223-1f59-428c-91dd-ec3df11866d1.webp)
히어로 이미지예요. 따뜻한 일출 빛이 가게 앞을 비추고, 배너용으로 넓게 구성했어요. · 비용 $0.045
generate image
$ wavespeed generate image "cozy coffee shop at sunrise, warm light in the windows, room for a headline" --aspect-ratio 16:9 --download좋아. 앞 창문에 "Open at 7"이라고 써 줘.
/filters:quality(82)/media/images/b021bf45-cfc6-419d-8e34-5d2db159895a.webp)
완료했어요. 창문에 "Open at 7"을 손글씨로 넣었고, 나머지는 그대로예요. · 비용 $0.045
edit image
$ wavespeed edit image "add the words \"Open at 7\" in white hand lettering on the front window" --image @./hero.jpg --download코딩 에이전트에서 이미지와 동영상 생성하기
Claude Code에서 이미지를 생성하려면 어떻게 하나요?
npm install -g @wavespeed/cli로 CLI를 설치하고, wavespeed login으로 로그인한 뒤 wavespeed skill install로 스킬을 추가하세요. 그다음 Claude Code에 이미지를 요청하면 wavespeed generate image를 실행해 파일을 프로젝트에 저장합니다.
Codex에서 이미지와 동영상을 생성하려면 어떻게 하나요?
CLI를 설치하고 로그인한 뒤 wavespeed skill install을 실행해 Codex가 명령을 알도록 하세요. Codex에 이미지나 동영상을 요청하면 대신 실행해 줍니다. /plugins에서 WaveSpeed 플러그인을 설치할 수도 있습니다.
에이전트가 실제로 실행하는 건 무엇인가요?
읽고 그대로 다시 실행할 수 있는 평범한 명령입니다: wavespeed generate image, wavespeed edit image, wavespeed generate video. 로컬 파일은 @./file로 전달하고 결과는 --download로 내려받습니다.
Cursor나 다른 코딩 에이전트에서도 되나요?
네. 터미널 명령을 실행할 수 있는 에이전트라면 CLI를 쓸 수 있고, 스킬이 명령을 알려 줍니다. MCP를 지원하는 에이전트는 호스팅 서버에 연결하는 방법도 있습니다.
동영상도 생성할 수 있나요?
네. wavespeed generate video는 텍스트, 시작 이미지 또는 참조 이미지로 클립을 만들고, wavespeed edit video와 extend video는 기존 동영상을 수정하거나 이어 붙입니다.
비용은 얼마인가요?
구독 없이 WaveSpeed 잔액에서 생성할 때마다 결제됩니다. --estimate를 붙이면 실행 전에 가격을 확인할 수 있고, 결과마다 실제 비용이 표시됩니다.
MCP로 에이전트가 할 수 있는 일
일상적인 이미지·동영상 작업용 단축 도구와 전체 카탈로그: 모델 검색, 모델의 실제 입력 확인, 가격 조회, 그리고 실행.
generate_image프롬프트로 이미지 생성 (참조 이미지 선택 가능)
edit_image기존 이미지 편집, 스타일 변경, 합성
generate_video프롬프트, 첫 프레임 또는 참조로 동영상 생성
edit_video기존 동영상 속 내용을 변경
extend_video새 장면으로 동영상 이어 붙이기
list_models실시간 카탈로그를 텍스트나 유형으로 검색
get_model_schema모델의 실제 입력, 필수 항목, 기본값
run_model모든 모델 실행; 로컬 @파일 입력은 자동 업로드
get_price사용 전에 비용 견적
get_balance크레딧 잔액 확인
upload_file로컬 파일을 호스팅 URL로 변환
get_prediction오래 걸리는 생성을 id로 다시 가져오기
list_predictions생성 기록 보기
list_billings청구 및 환불 내역을 항목별로 보기
get_usage일별·모델별 지출과 사용량 확인
delete_predictions기록에서 실행 삭제 (먼저 확인합니다)
upload_file은 로컬 서버에서만 제공됩니다. 원격 서버는 내 파일을 읽을 수 없습니다. 공개 URL을 전달하거나, HTTP 요청을 보낼 수 있는 도구에서 create_upload를 사용하거나, ChatGPT에서는 파일을 대화에 첨부하세요.
오픈소스. 오늘 바로 사용 가능.
MIT 라이선스, npm 의 @wavespeed 스코프로 게시, GitHub 에 호스팅. Issue 와 PR 환영.
그래픽 앱이 더 편하신가요? WaveSpeed Desktop을 사용해 보세요WaveSpeed에 연결하는 모든 방법 보기