WaveSpeed CLI · MCP

Claude Code, Codex, 터미널에서 이미지와 동영상 생성

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

CLI

@wavespeed/cli

한 번 설치하면 셸이나 스크립트에서 어떤 모델이든 실행할 수 있습니다.

$npm install -g @wavespeed/cli

MCP

@wavespeed/mcp

호스팅 MCP 서버: 어떤 MCP 클라이언트에서든 주소를 추가하고 로그인하세요.

https://api.wavespeed.ai/mcp

에이전트에 WaveSpeed 설정하기

사용하는 도구를 고르면 가장 빠른 설정 방법을 보여 드립니다. 어떤 방법이든 전체 모델 카탈로그를 쓰고, 실행 전에 가격을 확인할 수 있습니다.

Claude Code

플러그인

호스팅 MCP 서버와 WaveSpeed 스킬을 한 번에 설치합니다.

  1. 1

    WaveSpeed 마켓플레이스 추가

    $claude plugin marketplace add WaveSpeedAI/claude-plugins
  2. 2

    플러그인 설치

    $claude plugin install wavespeed@wavespeed
  3. 3

    Claude Code에서 /mcp를 실행하고 wavespeed를 선택한 뒤 브라우저에서 연결을 승인

    /mcp
그다음 이렇게 요청해 보세요: “사이버펑크 도시 스카이라인으로 16:9 히어로 이미지를 만들고, 먼저 가격을 알려 줘.”

다른 방법

스킬 없이 MCP 서버만 쓰려면:

$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp

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

  1. 1

    설치

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

    $npm install -g @wavespeed/cli
  2. 2

    로그인

    브라우저에서 access-key 페이지가 열립니다. 복사된 키를 자동으로 감지하고 즉시 검증합니다.

    $wavespeed login
  3. 3

    아무 모델이나 실행

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

    $wavespeed run wavespeed-ai/z-image/turbo -p "a cat"
  • 코딩 에이전트에게 CLI 가르치기

    스킬을 설치해 Codex, Claude Code, Cursor 등 에이전트가 CLI 호출 방법을 알게 합니다.

    $wavespeed skill install
  • Node.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 출력까지 — 세 가지 명령.

~/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
}

Claude Code와 Codex에서 이미지와 동영상 생성

CLI와 스킬을 한 번 설치하고 그냥 요청하세요. 코딩 에이전트가 명령을 실행하고 파일을 프로젝트에 저장합니다.

Claude Code · WaveSpeed CLI

우리 카페 랜딩 페이지에 쓸 16:9 히어로 이미지 만들어 줘. 아늑하고, 해 뜨는 분위기에, 헤드라인 넣을 자리도 있게.

해 뜰 무렵 거리에서 본 아늑한 카페

히어로 이미지예요. 따뜻한 일출 빛이 가게 앞을 비추고, 배너용으로 넓게 구성했어요. · 비용 $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"이라고 써 줘.

창문에 "Open at 7"이 적힌 같은 카페

완료했어요. 창문에 "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에 연결하는 모든 방법 보기