Claude × SpicyAPI · MCP 서버
Claude에서 이미지와 영상 만들기
Claude는 혼자서는 그림을 그릴 수 없습니다. SpicyAPI MCP 서버를 연결하면 가능해집니다. 평소 쓰는 말로 부탁하면 Claude가 이미지·영상 모델 145개 중 하나를 고르고, 정확한 요금을 보여 준 뒤, 사용자가 승인해야만 작업을 시작합니다.
아무것도 설치하고 싶지 않다면 Studio에서 바로 만들기
나: 잠든 용 옆을 지나 돌다리를 건너는 등불지기를 16:9 그림으로 만들어 줘. 가능하면 저렴하게.
- spicyapi_models_listspicyapi_model_getClaude: 저렴한 이미지 모델인 Z-Image을(를) 골라 지원하는 설정을 확인했습니다.
- spicyapi_task_create
Z-Image의 요금은 $0.01 장당입니다. 그림을 만들까요?
- spicyapi_task_wait완성했습니다. 그림은 아래와 같습니다.

- 이미지 모델
- 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 키, 위 앱 중 하나가 있으면 됩니다.
Node.js 설치
Claude는 npx로 서버를 시작하며, npx는 Node.js 22.13 이상에 포함되어 있습니다. node --version으로 확인하고, 없거나 버전이 낮다면 최신 LTS 버전을 설치하세요.
Node.js 받기API 키 만들기
콘솔에서 Create key를 선택해 키를 복사합니다. 키는 sk-spicy-로 시작하며 한 번만 표시됩니다. 하루 한도를 정해 두면 실수가 있어도 계획한 금액 이상은 쓰이지 않습니다.
API 키 열기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로 확인할 수 있습니다.
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SPICY_API_KEY" }
}
}
}Settings → Developer → Edit Config를 누르면 claude_desktop_config.json이 열립니다. 블록을 붙여 넣고(이미 mcpServers가 있으면 spicyapi 항목만 추가), YOUR_SPICY_API_KEY를 바꾼 다음 Claude Desktop을 완전히 종료했다가 다시 여세요.
// ~/.cursor/mcp.json
{
"mcpServers": {
"spicyapi": {
"command": "npx",
"args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
"env": { "SPICY_API_KEY": "YOUR_SPICY_API_KEY" }
}
}
}~/.cursor/mcp.json에 붙여 넣고(파일이 없으면 새로 만드세요), YOUR_SPICY_API_KEY를 바꿉니다. 도구가 보이지 않으면 Cursor를 다시 시작하세요.
제대로 동작하는지 확인
Claude에게 아래 두 가지를 물어보세요. 둘 다 무료입니다.
- “Check the SpicyAPI service status.”
- “What is my SpicyAPI balance?”
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에게 목록을 요청하거나 전체 모델 페이지에서 확인하세요.
이미지
- Seedream 5.0 Pro$0.036 장당부터
- Qwen Image 2.1$0.024 장당부터
- Seedream 5.0 Flash$0.029 장당부터
- Qwen Image 3.0 Pro$0.04 장당부터
- Qwen Image 3.0$0.03 장당부터
- Qwen Image 2.1 LoRA$0.03 장당부터
영상
- Wan 3.0$0.045 출력 초당부터
- Seedance 2.5$0.074 출력 초당부터
- Wan 3.0 Prime$0.061 출력 초당부터
- Seedance 2.0 Fast$0.023 출력 초당부터
- MiniMax H3$0.037 출력 초당부터
- Kling 4.0$0.216 출력 초당부터
같은 모델을 쓰는 다른 방법
MCP 서버 가이드
모든 도구와 앱, 문제 해결 표를 한곳에 모았습니다.
MCP 가이드 읽기명령줄
같은 키로 터미널에서 반복 작업과 일괄 작업을 실행할 수 있습니다.
CLI 페이지 열기API 키
Claude 전용으로 하루 한도가 있는 키를 만들거나, 필요 없어진 키를 폐기할 수 있습니다.
키 관리
자주 묻는 질문
그림 한 장으로 시작해 보세요
키를 만들고 서버를 추가한 다음, Claude에게 그림을 부탁해 보세요. 요금이 청구되기 전에 먼저 가격을 확인할 수 있습니다.