WaveSpeed CLI · MCP

모든 WaveSpeed 모델 — 터미널과 에이전트에서

모든 WaveSpeed AI 모델을 실행하는 단일 오픈소스 CLI. 이미지, 비디오, 오디오, 3D. Codex, Claude Code, Claude Cowork, Cursor 같은 터미널과 코딩 에이전트를 위해 설계되었습니다.

$npm install -g @wavespeed/cli

npm 에서 설치 MCP 설정 GitHub 에서 보기

세 가지 명령으로 출시 준비 완료

설치

Node 18+ 가 필요합니다. 한 번의 글로벌 설치로 wavespeed 바이너리를 어디서든 사용할 수 있습니다.

$npm install -g @wavespeed/cli

아무 모델이나 실행

모든 모델이 동일한 형식. 모델 ID 와 입력만 전달하면 CDN URL 이 반환되거나, --json 으로 스크립트에 파이프할 수 있습니다.

$wavespeed run wavespeed-ai/z-image/turbo -p "a cat"

사람과 에이전트 모두를 위해 설계

모델별 동적 도움말

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 출력까지 — 세 가지 명령.

~/projects/marketing

# 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
}

코딩 에이전트에 한 단계로 연결

추가 설정이 필요 없습니다. Codex, Claude Code, Claude Cowork 같은 코딩 에이전트는 이미 셸 명령을 실행할 줄 압니다. SKILL.md가 CLI 사용법을 알려줍니다.

$wavespeed skill install

Codex, Claude Code, Claude Cowork, Cursor 그리고 .claude/skills/* 를 자동으로 로드하는 모든 에이전트와 함께 작동합니다.

MCP가 더 편하다면? 어떤 MCP 클라이언트든 연결하세요

WaveSpeed MCP 서버는 Claude Desktop, Claude Code, Cursor, Cline 등 모든 MCP 클라이언트에 같은 실시간 카탈로그를 제공합니다. 모델을 검색하고, 모델의 실제 입력을 확인하고, 가격을 견적한 뒤 실행하세요.

wavespeed login으로 로그인했다면 MCP 서버도 같은 로그인을 사용합니다. 아니라면 WAVESPEED_API_KEY를 설정하세요.

Claude Code

$claude mcp add wavespeed -- npx -y @wavespeed/mcp

Cursor

클릭 한 번으로 Cursor에 설치하세요.

Cursor에 추가

Claude Desktop 및 기타 클라이언트

클라이언트 설정의 mcpServers 섹션에 추가하세요.

{
  "mcpServers": {
    "wavespeed": {
      "command": "npx",
      "args": ["-y", "@wavespeed/mcp"],
      "env": { "WAVESPEED_API_KEY": "wsk_..." }
    }
  }
}

7가지 도구

list_models

실시간 카탈로그를 텍스트나 유형으로 검색

get_model_schema

모델의 실제 입력, 필수 항목, 기본값

run_model

모든 모델 실행; 로컬 @파일 입력은 자동 업로드

get_price

사용 전에 비용 견적

get_balance

크레딧 잔액 확인

upload_file

로컬 파일을 호스팅 URL로 변환

get_prediction

오래 걸리는 생성을 id로 다시 가져오기

GitHub npm

오픈소스. 오늘 바로 사용 가능.

MIT 라이선스, npm 의 @wavespeed 스코프로 게시, GitHub 에 호스팅. Issue 와 PR 환영.

npm 에서 설치 GitHub 에서 스타