WaveSpeed CLI

모든 WaveSpeed 모델 — 터미널에서

모든 WaveSpeed AI 모델을 실행하는 단일 오픈소스 CLI. 이미지, 비디오, 오디오, 3D. 모델별로 실시간 가져오는 동적 도움말, 직접 정의하는 별칭 단축키, 에이전트를 위한 파이프 안전 JSON 출력.

$npm install -g @wavespeed/cli

npm 에서 설치 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 를 두면 Claude Code, Cursor, Codex 가 호출 방법을 압니다.

마법 없음, 데몬 없음

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://d2p7pg.cachecloud.net/.../skyline.jpeg"],
  "elapsed_ms": 4718
}

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

MCP 서버도, 추가 구성도 필요 없습니다. 코딩 에이전트는 이미 셸 명령 실행법을 압니다 — SKILL.md 가 CLI 사용 방법을 알려줍니다.

$wavespeed skill install

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

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

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

npm 에서 설치 GitHub 에서 스타