동영상
Wan 3.0
5초 클립당당 14 크레딧부터
모델 보기설치
패키지 관리자를 고르세요.
바이너리 하나, 받는 방법은 네 가지. 모든 채널이 같은 릴리스를 따라가요.
npm install -g @nolgia/cli플랫폼에 맞는 사전 빌드 바이너리를 설치해요. Node 18 이상이 필요해요.
brew install nolgiainc/nolgia/nolgiamacOS와 Linux. 최신 태그 릴리스를 따라가요.
cargo install nolgia-cli안정 버전 Rust 툴체인으로 소스에서 빌드해요.
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bashOS와 아키텍처를 감지해 PATH에 바이너리를 넣어요.
에이전트에 붙여넣기
Read https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/INSTALL_FOR_AGENTS.md and follow it end to end to install and set up the Nolgia CLI for me.코딩 에이전트가 sudo 없이 CLI를 설치하고, 인증하는 동안 기다렸다가, 스킬을 설치하고, 확인용 생성을 한 번 실행해요.
런북 읽기빠른 시작
인증하고 생성하세요.
nolgia auth login으로 한 번 로그인한 다음, 지원하는 모델이라면 무엇이든 생성하세요. --shot 플래그를 반복해 멀티샷 시퀀스를 구성하고, --cost-only를 넘기면 실행 전에 작업 가격을 확인할 수 있어요.
# Authenticate once: opens a device login in your browser
nolgia auth login
# Generate an 8-second clip from a prompt
nolgia gen video \
--model veo-3.1 \
--prompt "a street bike carving a coastal road at dusk" \
--duration-seconds 8 \
--out clip.mp4# Direct a multi-shot sequence: one --shot per beat.
# Add --cost-only first to see the credit estimate before spending.
nolgia gen video \
--model veo-3.1 \
--shot "8:WIDE SHOT: city skyline at golden hour, slow push in" \
--shot "6:MEDIUM SHOT: rider mounts the bike, engine catches" \
--shot "8:CLOSE UP: throttle twists, headlight flares" \
--out sequence.mp4 \
--cost-onlynolgia gen video --model veo-3.1 --prompt "…" --cost-onlyAPI의 POST /jobs/cost도 같은 값을 반환해요.
터미널에서 사는 사람들을 위해 만들었어요.
지켜봐야 할 대시보드는 없어요. Studio로 할 수 있는 모든 것을 명령이나 도구 호출 한 번으로 할 수 있어요.
사람과 에이전트를 위한 하나의 클라이언트
터미널과 MCP 서버 뒤에는 같은 플랫폼이 있어요. 직접 스크립트를 짜거나 Claude Code에게 맡기세요. 기능은 똑같아요.
투명한 크레딧 요금
어떤 생성 명령이든 --cost-only를 붙이면 쓰기 전에 예상 크레딧을 확인할 수 있어요. 예상치 못한 과금도, 숨은 배수도 없어요.
비동기 작업 모델
모든 생성은 기다리거나 폴링할 수 있는 작업이에요. 한꺼번에 실행해 두고 자리를 비웠다가, 결과가 나오면 가져가세요.
네이티브 멀티샷 시퀀스
--shot 플래그를 반복해 시네마틱 시퀀스를 구성하세요. 와이드, 미디엄, 클로즈업 장면을 명령 하나로 연출할 수 있어요.
어디서나 이미지에서 동영상으로
지원하는 모든 모델에서 일관된 플래그 하나로 스틸 이미지에서 동영상을 만들어요.
Claude Code에서 작동
어떤 MCP 클라이언트든 Bearer 토큰과 함께 호스팅 서버를 지정하면 모든 도구가 에이전트에 나타나요.
MCP 서버
에이전트에게 플랫폼 전체를 맡기세요.
NOLGIA MCP 서버는 https://mcp.nolgia.ai/mcp에서 호스팅되며 MCP Streamable HTTP 전송 방식을 써요. Bearer PAT나 JWT로 인증하면 Claude Code, Cursor, 또는 헤더를 보낼 수 있는 모든 MCP 클라이언트에서 도구 81개를 모두 쓸 수 있어요. 토큰 대신 로그인으로 연결하는 어시스턴트는 MCP 페이지에서 안내해요.
{
"mcpServers": {
"nolgia": {
"url": "https://mcp.nolgia.ai/mcp",
"headers": {
"Authorization": "Bearer nol_your_token_here"
}
}
}
}계정에서 개인 액세스 토큰을 생성한 다음 Authorization 헤더에 넣으세요. 클라이언트를 다시 시작하면 서버가 인식돼요.
서버 자체 레지스트리에서 읽어 온 도구 81개
Generate
| 도구 | 용도 |
|---|---|
nolgia_text_to_image | Generate image from text |
nolgia_image_to_image | Generate image from an image |
nolgia_text_to_video | Generate video from text |
nolgia_image_to_video | Animate an image into video |
nolgia_text_to_audio | Generate audio from text |
nolgia_run_preset | Run a preset |
nolgia_render_blocks | Assemble clips and narration into one video |
nolgia_multicam_plan | Plan a Multicam job |
nolgia_multicam_start | Start a Multicam job |
nolgia_multicam_run | Check a Multicam job |
nolgia_multicam_download | Download every Multicam angle |
nolgia_multicam_cancel | Stop a Multicam job |
nolgia_generate_3d | Generate a 3D model |
nolgia_generate_set | Generate a set of images |
nolgia_miroge_options | Price a Miroge remake |
nolgia_miroge | Remake a clip with Miroge |
nolgia_analyze_reference | Analyze a reference video |
Your library
| 도구 | 용도 |
|---|---|
nolgia_list_assets | List generated assets |
nolgia_get_asset | Open an asset |
nolgia_delete_asset | Trash an asset |
nolgia_update_asset_tags | Set an asset's tags |
nolgia_upload_asset | Upload an image |
nolgia_list_characters | List saved characters |
nolgia_get_character | Get one character |
nolgia_create_character | Save a character |
nolgia_update_character | Update a character |
nolgia_delete_character | Delete a character |
nolgia_list_styles | List saved styles |
nolgia_create_style | Save a style |
nolgia_delete_style | Delete a saved style |
nolgia_transcribe_asset | Transcribe an asset |
nolgia_get_transcript | Get an asset transcript |
nolgia_suggest_clips | Find short video clips |
nolgia_create_clips | Create short video clips |
nolgia_get_set | Get a set of images |
nolgia_get_miroge | Check a Miroge remake |
nolgia_get_reference_analysis | Read a reference analysis |
nolgia_apply_look | Apply a look to generations |
nolgia_look_from_analysis | Make a look from a reference analysis |
nolgia_merge_look_analyses | Teach a look from several videos |
nolgia_match_look | Re-cut a timeline to a look |
nolgia_score_edit_dna | Score a render against a look |
Projects
| 도구 | 용도 |
|---|---|
nolgia_list_projects | List projects |
nolgia_get_project | Get one project |
nolgia_create_project | Create a project |
nolgia_update_project | Update a project |
nolgia_delete_project | Delete a project |
nolgia_add_project_assets | Add assets to a project |
nolgia_remove_project_asset | Remove an asset from a project |
nolgia_list_canvases | List canvases |
nolgia_get_canvas | Get a canvas |
nolgia_create_canvas | Create a canvas |
nolgia_update_canvas | Update a canvas |
Edit sessions and tweaks
| 도구 | 용도 |
|---|---|
nolgia_list_tweak_scopes | List image tweak scopes |
nolgia_create_edit_session | Start an edit session |
nolgia_get_edit_session | Read an edit session |
nolgia_edit_session_step | Apply the next image edit |
nolgia_revert_edit_session | Revert an edit session |
nolgia_estimate_edit_session | Estimate the next edit |
Presets
| 도구 | 용도 |
|---|---|
nolgia_list_presets | List presets |
nolgia_get_preset | Get one preset |
Timelines
| 도구 | 용도 |
|---|---|
nolgia_validate_mask | Validate a timeline mask |
nolgia_validate_motion | Validate timeline motion |
nolgia_list_color_presets | List color-grade presets |
nolgia_get_render | Check a render |
Desktop apps
| 도구 | 용도 |
|---|---|
nolgia_app_status | List connected desktop apps |
nolgia_app_info | Read a desktop app's state |
nolgia_app_run | Run code in a desktop app |
nolgia_app_command | Check a desktop app command |
nolgia_app_preview | Preview a desktop app's document |
nolgia_app_import | Import an asset into a desktop app |
nolgia_app_export | Export from a desktop app |
nolgia_app_save | Save the document in a desktop app |
nolgia_app_open | Open a document in a desktop app |
nolgia_app_dit | Do the DIT on the person's computer |
nolgia_app_transcribe | Transcribe clips in Premiere Pro |
Models, account and jobs
| 도구 | 용도 |
|---|---|
nolgia_list_models | List models |
nolgia_get_account | Get the signed-in account |
nolgia_get_usage | Get generation counts |
nolgia_cancel_job | Cancel a generation job |
nolgia_list_jobs | List generation jobs |
FAQ
터미널에서 나온 질문.
- nolgia CLI는 어떻게 설치하나요?
- 다음 방법으로 설치할 수 있어요: npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli) 및 curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). 모든 채널이 같은 릴리스를 따라가요.
- 터미널에서는 어떻게 로그인하나요?
- nolgia auth login을 한 번 실행하세요. 브라우저에서 기기 로그인이 열리고, CLI가 세션을 유지해요.
- 작업을 실행하기 전에 비용을 확인할 수 있나요?
- 네. 어떤 생성 명령이든 --cost-only를 붙이면 크레딧을 쓰지 않고 예상 크레딧만 확인할 수 있어요.
- CLI로 무엇을 생성할 수 있나요?
- 플랫폼이 공개한 모델로 이미지, 동영상, 오디오를 만들 수 있어요. --shot 플래그를 반복해 멀티샷 동영상 시퀀스를 만들거나, 스틸 이미지로 동영상을 만들 수도 있어요.
- Claude Code나 다른 에이전트는 어떻게 연결하나요?
- MCP 클라이언트를 https://mcp.nolgia.ai/mcp 주소로 지정하고 개인 액세스 토큰을 담은 Authorization: Bearer 헤더를 보내면, 에이전트에 도구 81개가 모두 나타나요.
- CLI와 앱이 크레딧을 공유하나요?
- nolgia auth login으로 로그인하면 공유해요. CLI는 앱과 똑같이 월간 요금제 크레딧을 먼저 쓰고 그다음 충전 크레딧을 써요. API와 MCP 서버에서도 쓰는 개인 액세스 토큰(NOLGIA_TOKEN)은 충전 크레딧만 써요. ChatGPT나 Claude처럼 OAuth로 연결한 어시스턴트는 앱과 똑같이 크레딧을 써요.
- 코딩 에이전트가 CLI를 대신 설정해 줄 수 있나요?
- 네. ‘에이전트에 붙여넣기’ 아래의 한 줄 안내를 복사하세요. 코딩 에이전트가 https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md의 설치 런북을 따라 설치, 인증, 스킬, 확인용 생성까지 진행해요.
- 작업 비용은 어떻게 확인하나요?
- CLI에서는 --cost-only를, API에서는 POST /jobs/cost를 쓰세요. 둘 다 같은 가격 계산기를 써서 생성 전에 같은 예상 크레딧을 알려 줘요.