Seedance CLI: 터미널과 AI 앱에서 동영상과 이미지 생성
Seedance CLI는 터미널은 물론 Claude Code, Codex, Cursor, OpenCode처럼 명령을 실행할 수 있는 AI 앱에서도 사용할 수 있습니다. 웹사이트와 같은 크레딧을 같은 가격으로 사용하며, 컴퓨터의 파일을 참조 소재로 쓸 수 있습니다.
Claude Code, Codex, Cursor, OpenCode 등 컴퓨터의 AI 앱을 사용하는 분을 위한 방법입니다. 웹이나 모바일 앱에서 Claude, ChatGPT를 사용한다면 MCP를 이용하세요. MCP 사용 방법 보기
이용 방법
- 1
지시를 AI 앱에 보내기
아래 지시를 Claude Code, Codex, Cursor, OpenCode 등의 AI 앱에 붙여 넣으면 앱이 CLI를 설치합니다.
아래 지시문을 복사해 사용 중인 AI 앱에 보내세요
Read https://www.seedance2ai.io/mcp-guide.txt and set up the Seedance2 CLI on this computer. Let me sign in in my browser, and show me the credit cost before generating. - 2
로그인 및 접근 허용
앱이 브라우저를 엽니다. Seedance 2.0 AI 계정에 로그인하고 접근을 허용하세요.
- 3
만들고 싶은 내용을 말하기
예: “비 오는 밤거리를 떠내려가는 종이배 영상을 5초로 만들어 줘”, “비를 바라보는 주황색 고양이 이미지를 만들어 줘.” 앱이 필요한 크레딧을 알려 준 뒤 생성하고(비용이 큰 경우에는 먼저 확인을 요청합니다), 동영상이나 이미지를 현재 작업 폴더(원하면 다른 위치)에 저장합니다. 생성한 결과는 웹사이트의 기록에도 표시됩니다.
실제 실행 화면
한 문장으로 요청하면 AI 앱이 명령을 실행합니다. 표시된 출력은 실제 실행 결과입니다. 대기 시간은 줄여서 표시했으며, 이 생성에는 실제로 약 2분이 걸렸습니다.
직접 설정하기
- 1
CLI 설치
첫 번째 명령으로 CLI를 설치합니다. macOS 또는 Linux의 Node.js 22 이상이 필요하며, Windows에서는 WSL을 사용하세요.
npm install -g @seedance2ai/cli - 2
브라우저에서 로그인 및 승인
두 번째 명령을 실행한 뒤, 자동으로 열리는 브라우저 창에서 로그인하고 접근을 허용합니다.
seedance2 auth login - 3
크레딧 잔액 확인
세 번째 명령으로 크레딧 잔액을 확인합니다.
seedance2 account
생성하기
설정이 끝나면 생성하려는 내용을 AI 앱에 말하기만 하면 됩니다. 직접 생성하려면 다음 단계를 따르세요.
- 1
요청 작성
request.json 파일을 만들고 아래 예시처럼 모델과 해당 필드를 지정하세요. 이미지와 동영상 필드에는 컴퓨터의 파일도 지정할 수 있습니다.
request.json
{"model":"seedance2","quality_tier":"fast","prompt":"A paper boat drifting down a rainy street at night","duration":"5","resolution":"720p"} - 2
가격 확인
이 명령으로 필요한 크레딧을 확인하세요. 가격 확인은 무료입니다.
seedance2 estimate --input request.json - 3
생성 시작
CREDITS를 이전 단계에서 확인한 가격으로 바꾸세요. 이 가격을 넘는 생성은 제출되지 않습니다. 명령은 생성이 끝날 때까지 기다린 뒤 작업 ID를 반환합니다.
seedance2 create --input request.json --max-credits CREDITS --wait - 4
결과 다운로드
TASK_ID를 이전 단계에서 반환된 작업 ID로 바꾸세요.
seedance2 download TASK_ID --output result.mp4
seedance2 --help로 모든 명령을 확인할 수 있습니다.
지원 모델
각 모델의 옵션은 웹사이트 및 API와 동일합니다.
- Seedance 2.5동영상텍스트, 이미지 또는 참조 미디어로 동영상을 생성합니다. 4~30초, 최대 2K, 사운드 포함. 구매 이력이 필요합니다.
- Seedance 2.0동영상텍스트, 이미지 또는 참조 미디어로 동영상을 생성합니다. 4~15초이며 Mini, Fast, Pro 품질 등급을 제공합니다.
- Kling 4.0동영상텍스트, 참조 미디어 또는 키프레임으로 동영상을 생성합니다. 3~30초, 720p 또는 1080p.
- GPT Image 2.5이미지텍스트 기반 이미지 생성과 이미지 편집을 지원합니다.
- GPT Image 2이미지텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 한 번에 최대 4장까지 생성합니다.
- Nano Banana Pro이미지텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 최대 4K로 출력합니다.
- Nano Banana 2이미지텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 최대 4K로 출력합니다. 검색 결과를 참고한 생성도 선택할 수 있습니다.
- Nano Banana 2 Lite이미지텍스트 기반 이미지 생성과 이미지 편집을 1K로 지원하며, 비용이 가장 낮습니다.
- Seedream 5 Pro이미지텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 1K 또는 2K로 출력합니다.
- Seedream 5 Lite이미지텍스트 기반 이미지 생성과 이미지 편집을 지원하며, 2K 또는 4K로 출력합니다.
크레딧 및 요금
- 연결, 잔액 확인, 견적 요청, 작업 상태 확인에는 크레딧이 차감되지 않습니다.
- 크레딧은 생성을 제출할 때만 웹사이트 및 API와 공유하는 개인 잔액에서 차감됩니다.
- 생성에 실패하면 크레딧이 자동으로 환불됩니다.
- 동영상 길이를 자동으로 설정하면 최대 길이에 해당하는 크레딧을 먼저 확보하고, 생성 후 사용하지 않은 크레딧을 환불합니다.
- AI 어시스턴트 구독 요금은 Seedance 2.0 AI 크레딧과 별도로 청구됩니다.
자주 묻는 질문
어떤 AI 앱에서 Seedance CLI를 사용할 수 있나요?
컴퓨터에서 명령을 실행할 수 있는 AI 앱이라면 모두 사용할 수 있습니다. 터미널: Claude Code, Codex, Gemini CLI, OpenCode, Qwen Code. 코드 편집기: Cursor, Windsurf, Trae, Kiro. 편집기 확장 프로그램: GitHub Copilot(Agent 모드), Cline, Roo Code. 웹이나 모바일 앱의 Claude, ChatGPT, Gemini 같은 채팅 앱은 명령을 실행할 수 없으므로 MCP를 이용하세요. CLI를 사용하려면 Node.js 22 이상이 필요하며 macOS와 Linux를 지원합니다. Windows에서는 WSL을 이용하세요.
컴퓨터에 저장된 이미지나 동영상을 사용할 수 있나요?
네. Claude Code, Codex, Cursor, OpenCode처럼 컴퓨터에서 실행되는 AI 앱에서는 생성 전에 앱이 파일을 대신 업로드합니다. Claude, ChatGPT, Gemini 같은 채팅 앱은 컴퓨터의 파일에 접근할 수 없으므로, 참조 파일은 공개 HTTPS URL로 접근할 수 있어야 합니다. 직접 링크를 제공하는 서비스에 파일을 업로드한 후 요청에 해당 링크를 포함해 주세요.
어떤 크레딧이 사용되나요?
웹사이트 및 API와 공유하는 개인 크레딧 잔액이 사용됩니다. 팀 크레딧은 사용되지 않습니다.