본문으로 건너뛰기

Claude × SpicyAPI · MCP 서버

Claude에서 이미지와 영상 만들기

Claude는 혼자서는 그림을 그릴 수 없습니다. SpicyAPI MCP 서버를 연결하면 가능해집니다. 평소 쓰는 말로 부탁하면 Claude가 이미지·영상 모델 145개 중 하나를 고르고, 정확한 요금을 보여 준 뒤, 사용자가 승인해야만 작업을 시작합니다.

아무것도 설치하고 싶지 않다면 Studio에서 바로 만들기

Claude Code · 세션 예시
  1. 나: 잠든 용 옆을 지나 돌다리를 건너는 등불지기를 16:9 그림으로 만들어 줘. 가능하면 저렴하게.

  2. spicyapi_models_listspicyapi_model_get
    Claude: 저렴한 이미지 모델인 Z-Image을(를) 골라 지원하는 설정을 확인했습니다.
  3. spicyapi_task_create

    Z-Image의 요금은 $0.01 장당입니다. 그림을 만들까요?

  4. spicyapi_task_wait
    완성했습니다. 그림은 아래와 같습니다.안개 낀 동굴의 돌다리 위에서 등불을 든 후드 쓴 인물, 뒤쪽 기둥을 휘감고 잠든 거대한 용
세션이 진행되는 방식을 보여 주는 예시입니다. 그림은 Z-Image 모델 페이지의 실제 샘플이며, 승인하기 전에는 아무것도 청구되지 않습니다.
이미지 모델
78
영상 모델
67
이미지는
$0.0018장당
영상은
$0.011초당

구독 없음 · 호출할 때마다 미국 달러로 결제

Claude가 이미지를 만들 수 있나요?

혼자서는 못 하지만 MCP를 쓰면 가능합니다. 핵심만 정리했습니다.

  • 혼자서는: 불가능

    Claude가 만드는 것은 텍스트와 코드입니다. 다이어그램이나 차트를 코드로 그릴 수는 있지만, 사진·일러스트·영상은 만들지 못합니다.

  • MCP를 쓰면: 가능

    MCP(Model Context Protocol)는 Claude가 외부 도구를 쓰게 해 주는 규격입니다. SpicyAPI 서버를 추가하면 Claude가 모델 찾기, 파일 업로드, 견적 확인, 작업 시작까지 대신 해 줍니다.

  • 지출은 사용자가 통제

    비용이 드는 단계마다 먼저 멈추고 미국 달러 금액과 함께 확인을 요청합니다. Claude가 대신 승인할 수는 없습니다.

사용할 수 있는 Claude 앱

SpicyAPI MCP 서버는 사용자의 컴퓨터에서 실행됩니다. 그래서 지금 쓸 수 있는 곳이 정해집니다.

  • Claude Code

    끝까지 동작

    터미널이나 코드 에디터에서 실행됩니다. SpicyAPI의 요금 확인 질문이 그대로 표시되고 사용자의 승인을 기다립니다. 처음 시작하기에 가장 좋은 곳입니다.

  • Claude Desktop

    연결됨, 유료 실행은 확인 필요

    설정 파일에 블록 하나만 추가하면 됩니다. 모델 둘러보기와 요금 조회는 가능합니다. 유료 작업을 시작하려면 앱이 SpicyAPI의 확인 질문을 표시할 수 있어야 하며, 표시하지 못하는 버전에서는 요금이 청구되기 전에 작업이 중단됩니다.

  • 브라우저의 claude.ai

    아직 미지원

    웹 앱은 호스팅형 커넥터 URL에만 연결되는데, SpicyAPI는 아직 제공하지 않습니다. 당분간은 Claude Code나 Claude Desktop을 쓰세요.

  • Cursor, VS Code, Codex, Windsurf

    같은 서버

    같은 명령이 다른 AI 앱에서도 동작합니다. Claude 모델을 쓰는 경우도 마찬가지입니다.

앱별 설정 방법

3단계로 설정하기

약 10분이면 되고 코딩은 필요 없습니다. Node.js와 SpicyAPI 키, 위 앱 중 하나가 있으면 됩니다.

  1. Node.js 설치

    Claude는 npx로 서버를 시작하며, npx는 Node.js 22.13 이상에 포함되어 있습니다. node --version으로 확인하고, 없거나 버전이 낮다면 최신 LTS 버전을 설치하세요.

    Node.js 받기
  2. API 키 만들기

    콘솔에서 Create key를 선택해 키를 복사합니다. 키는 sk-spicy-로 시작하며 한 번만 표시됩니다. 하루 한도를 정해 두면 실수가 있어도 계획한 금액 이상은 쓰이지 않습니다.

    API 키 열기
  3. Claude에 SpicyAPI 추가

    사용하는 앱에 맞는 블록을 복사하고, 자리표시자 대신 본인의 키를 넣은 뒤 앱을 다시 시작하세요.

export SPICY_API_KEY="sk-spicy-..."
claude mcp add --scope user spicyapi \
  -e SPICY_API_KEY=$SPICY_API_KEY \
  -- npx --yes --package=@spicyapi/mcp spicyapi-mcp

두 명령은 같은 터미널에서 실행하세요. --scope user를 붙이면 모든 프로젝트에서 SpicyAPI를 쓸 수 있습니다. --scope project는 키가 저장소에 기록되므로 쓰지 마세요. claude mcp list로 확인할 수 있습니다.

제대로 동작하는지 확인

Claude에게 아래 두 가지를 물어보세요. 둘 다 무료입니다.

  1. “Check the SpicyAPI service status.”
  2. “What is my SpicyAPI balance?”
다른 앱, Windows, 프록시 환경이라면: 전체 설정 및 문제 해결

Claude에게 부탁할 수 있는 것

평소 말투로 부탁하면 Claude가 모델과 설정을 고릅니다. 원하는 모델을 직접 지정해도 됩니다.

  • 설명만으로 그림 만들기

    “Make a 3:4 portrait of a lighthouse keeper at dawn, film grain. Pick an inexpensive model and show me the price first.”

    모든 이미지 모델에서 텍스트로 이미지를 만들 수 있습니다.

    $0.0018 장당부터

  • 사진에 움직임 주기

    “Turn ~/Pictures/harbour.jpg into a 5-second clip with a slow push-in.”

    Claude가 컴퓨터에 있는 사진을 업로드하고 이미지-영상 작업을 시작합니다.

    $0.011 출력 초당부터

  • 영상 길게 늘리기

    “Continue my last video for another 5 seconds. Keep the camera drifting toward the window.”

    지원하는 모델에서는 영상이 끝난 지점부터 이어서 만들어 줍니다.

    $0.011 출력 초당부터

  • 결과물 선명하게 만들기

    “Upscale the picture you just made.”

    이미지·영상용 업스케일러가 있으며, 요금은 장당 또는 초당으로 매겨집니다.

    $0.012 장당부터

쓰기 전에 비교하기

모델 둘러보기와 견적 조회는 무료입니다.

“Compare what a 5-second clip costs on three video models.”

비용

  • 서버는 무료

    MCP 서버는 무료 오픈소스입니다. 승인한 작업에 대해서만 비용을 냅니다.

  • 쓴 만큼 결제

    이미지나 영상 한 건마다 Claude 요금제가 아니라 SpicyAPI 잔액에서 미국 달러로 차감됩니다. 구독은 없습니다.

  • 요금을 먼저, 작업은 그다음

    Claude는 유료 작업 전에 항상 정확한 견적을 가져옵니다. 영상은 초당 요금이라 길수록 비용이 늘어납니다.

  • 작업이 실패하면

    실패한 작업을 위해 묶어 둔 금액은 보통 풀립니다. 일부 모델은 거부된 요청에도 요금이 청구된다고 모델 페이지에 적어 두었습니다.

Claude가 호출할 수 있는 모델

현재 카탈로그의 이미지·영상 모델 145개 중 일부입니다. 나머지는 Claude에게 목록을 요청하거나 전체 모델 페이지에서 확인하세요.

이미지

영상

모든 모델 보기

무엇을 보낼지는 Claude가 정합니다

Claude는 Anthropic의 이용 정책을 따르므로, 선택한 모델이 받아 줄 요청이라도 표현을 바꾸거나 거절할 수 있습니다. 이는 SpicyAPI에서 바꿀 수 없습니다. 이 페이지는 모델의 폭과 쓴 만큼 내는 요금에 관한 안내입니다. 프롬프트가 쓴 그대로 모델에 전달되길 원한다면 Studio를 쓰거나 API를 직접 호출하세요. SpicyAPI는 자체 콘텐츠 필터를 두지 않으며, 무엇을 만들 수 있는지는 모델에 따라 달라집니다.

같은 모델을 쓰는 다른 방법

  • MCP 서버 가이드

    모든 도구와 앱, 문제 해결 표를 한곳에 모았습니다.

    MCP 가이드 읽기
  • 명령줄

    같은 키로 터미널에서 반복 작업과 일괄 작업을 실행할 수 있습니다.

    CLI 페이지 열기
  • API 키

    Claude 전용으로 하루 한도가 있는 키를 만들거나, 필요 없어진 키를 폐기할 수 있습니다.

    키 관리

자주 묻는 질문

그림 한 장으로 시작해 보세요

키를 만들고 서버를 추가한 다음, Claude에게 그림을 부탁해 보세요. 요금이 청구되기 전에 먼저 가격을 확인할 수 있습니다.