WaveSpeed MCP · CLI

Claude, ChatGPT, Cursor, Codex에서 이미지와 동영상 생성

이미 쓰고 있는 AI 에이전트에 WaveSpeed를 연결하고 요청만 하세요. 에이전트가 모델을 찾고 가격을 알려 준 뒤 생성합니다. 브라우저에서 한 번만 로그인하면 되고, 복사할 API 키가 없습니다.

원클릭으로 연결

https://api.wavespeed.ai/mcp

WaveSpeed MCP

만들 수 있는 것

WaveSpeed MCP로 만든 실제 결과물입니다. 작업하는 곳을 고른 뒤 클릭 한 번으로 요청을 보내거나 복사하세요.

보내는 곳

이미지 생성

설명 하나로 만드는 패션 화보 사진.

Create a fashion editorial photo of a young woman standing between sculptural archways painted coral and sky blue, one hand on the curved wall. She wears a voluminous ivory gown with ruffled sleeves and tiny pearl details, her long dark hair in a single thick braid with a small white flower. Soft studio light, saturated colours, the grain of 35mm film.

동영상 생성

사운드와 카메라 무빙까지 갖춘 영화 같은 클립.

Make an 8-second video of a young man with curly hair in a yellow raincoat running up a stone seaside staircase in the rain, laughing. The handheld camera follows him to the top, where he catches his breath and looks out at a stormy sea as the wind blows his hood back. Sound of rain, waves and his breathing.

숏드라마

일관된 등장인물과 대사로 이야기를 한 장면으로 만듭니다.

Turn my story into a short drama scene with a consistent cast: a gruff old lighthouse keeper finds a soaked young sailor at his door on a stormy night. First make a still of both characters, then a 10-second scene with spoken dialogue. He says: "You're lucky the light was still on." She answers: "I thought this place was empty."

제품 리뷰 UGC

사진 한 장으로 만드는 크리에이터 스타일의 제품 리뷰.

Make a creator-style product review of my product (ask me for a photo): a friendly creator at her kitchen table holds it up to her phone and says: "Okay, I've used this bottle every day for a month. Ice lasts the whole day, and it hasn't leaked in my bag once." Vertical, handheld, natural light, about 8 seconds.

Claude가 요청하면 직접 파일을 첨부하세요.

전
후

광고 리크리에이터

레퍼런스 광고의 카메라 무빙, 속도감, 분위기는 그대로, 내 제품을 등장시킵니다.

Recreate the reference ad I give you (ask me for the video) for my own product (ask me for a photo): keep its camera move, pacing, lighting and mood, but show my product instead. Tell me the price first.

Claude가 요청하면 직접 파일을 첨부하세요.

전
후

4K 업스케일

작고 흐릿한 이미지를 선명한 4K 이미지로 바꿉니다.

Upscale my image to 4K (ask me to attach it). Keep the face, colours and composition exactly as they are, just make it sharp. Use a dedicated upscaler and tell me the price first.

Claude가 요청하면 직접 파일을 첨부하세요.

전
후

아우라 편집

글로우, 스피드 램프, 플래시 전환으로 내 영상을 새롭게 연출합니다.

Turn my footage (ask me for the video) into an aura edit: keep the person and the camera movement, add a glowing aura outline, speed-ramped slow motion, flash-frame transitions and film grain with light leaks, cut to a pulsing electronic beat.

Claude가 요청하면 직접 파일을 첨부하세요.

에이전트에 WaveSpeed 설정하기

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

Claude

원클릭

웹의 Claude와 Claude Desktop에서 모두 작동합니다. 설치할 것이 없습니다.

  1. 1

    버튼을 클릭하면 WaveSpeed가 커스텀 커넥터로 입력된 상태로 Claude가 열립니다. Add를 클릭하세요.

    Claude에 추가
  2. 2

    요청이 오면 WaveSpeed에 로그인하고 연결을 승인

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

다른 방법

직접 추가하려면: Claude에서 Customize → Connectors → Add custom connector를 열고 이 주소를 붙여 넣으세요.

https://api.wavespeed.ai/mcp

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

WaveSpeed를 한 번 연결하고 그냥 요청하세요. 에이전트가 도구를 고르고, 이미지를 만들고, 비용까지 알려 줍니다.

ChatGPT · WaveSpeed 연결됨

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

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

히어로 이미지예요. 따뜻한 일출 빛이 가게 앞을 비추고, 배너용으로 넓게 구성했어요. · 비용 $0.045

generate_image · 16:9
generate_image
  prompt: cozy coffee shop at sunrise, warm light in the windows, room for a headline
  aspect_ratio: 16:9

좋아. 앞 창문에 "Open at 7"이라고 써 줘.

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

완료했어요. 창문에 "Open at 7"을 손글씨로 넣었고, 나머지는 그대로예요. · 비용 $0.045

edit_image
edit_image
  prompt: add the words "Open at 7" in white hand lettering on the front window
  images: [hero.jpg]

AI 어시스턴트에서 이미지와 동영상 생성하기

WaveSpeed로 ChatGPT에서 이미지를 생성하려면 어떻게 하나요?

ChatGPT에서 Plugins를 열고 Add custom MCP server를 선택한 뒤 https://api.wavespeed.ai/mcp를 붙여 넣고 WaveSpeed 계정으로 로그인하세요. 그다음 "해 뜨는 카페의 16:9 히어로 이미지 만들어 줘"처럼 평소 말투로 요청하면 됩니다.

Claude Desktop에서 이미지와 동영상을 생성할 수 있나요?

네, WaveSpeed를 커넥터로 추가하면 됩니다. Claude(데스크톱 또는 웹)에서 Customize → Connectors → Add custom connector를 열고 https://api.wavespeed.ai/mcp를 붙여 넣은 뒤 로그인하세요. 이후 Claude가 이미지와 동영상을 만들고 편집해 줍니다.

Codex에서 이미지와 동영상을 생성하려면 어떻게 하나요?

Codex에서 /plugins를 열고 WaveSpeed를 설치한 뒤 브라우저에서 연결을 승인하세요. 그러면 Codex가 프로젝트 작업 중에 이미지와 동영상을 생성하고 프로젝트에 저장할 수 있습니다.

Claude Code에서 이미지를 생성하려면 어떻게 하나요?

WaveSpeed 마켓플레이스를 추가하고 플러그인을 설치한 다음, Claude Code에서 /mcp를 실행해 연결을 승인하세요. 이미지나 동영상을 요청하면 Claude Code가 WaveSpeed를 호출해 줍니다.

같은 채팅에서 이미지를 수정하거나 그 이미지로 동영상을 만들 수 있나요?

네. "받침대를 민트 그린으로 바꿔 줘"처럼 수정을 요청하면 에이전트가 마지막 이미지를 편집합니다. 동영상을 요청하면 이미지를 움직이게 하거나 클립 전체를 만들 수도 있습니다.

비용은 얼마인가요?

구독 없이 WaveSpeed 잔액에서 생성할 때마다 결제됩니다. 에이전트가 실행 전에 가격을 보여 줄 수 있고, 모든 결과에 실제 비용이 표시됩니다.

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에서는 파일을 대화에 첨부하세요.

터미널이 더 편하다면 CLI를 사용하세요

셸, 스크립트, 명령을 실행하는 에이전트에서도 같은 카탈로그를 쓸 수 있습니다. 모든 모델을 하나의 오픈소스 명령으로 실행하고, JSON 출력을 파이프로 넘기세요.

CLI

@wavespeed/cli

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

$npm install -g @wavespeed/cli

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

  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
}

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

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

그래픽 앱이 더 편하신가요? WaveSpeed Desktop을 사용해 보세요WaveSpeed에 연결하는 모든 방법 보기