如何安裝 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 或其他 AI 代理？

將你的 MCP 用戶端指向 https://mcp.nolgia.ai/mcp，並在 Authorization: Bearer 標頭中帶上個人存取權杖，全部 81 項工具就會出現在你的 AI 代理中。

CLI 和 App 共用點數嗎？

用 nolgia auth login 登入時會共用：CLI 跟 App 一樣，先扣每月方案點數，再扣加值點數。個人存取權杖（NOLGIA_TOKEN，API 與 MCP 伺服器也使用它）只會扣加值點數。透過 OAuth 連接的助理（例如 ChatGPT 或 Claude）扣點方式與 App 相同。

我的 AI 程式設計代理能幫我設定 CLI 嗎？

可以。複製「Paste this into your agent」底下那一行指示。它會引導你的 AI 程式設計代理前往 https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md 的安裝手冊，逐步完成安裝、驗證、技能設定與一次測試生成。

如何查看任務的費用？

在 CLI 使用 --cost-only，或在 API 使用 POST /jobs/cost。兩者使用相同的計價器，會在生成前回傳相同的預估點數。

CLI 與 MCP 伺服器

從終端機或你的 AI 代理生成。

nolgia CLI 是用於圖片、影片與音訊生成的單一 Rust 執行檔。NOLGIA MCP 伺服器則把同一個平台開放給 Claude Code 與任何其他 AI 代理。一個帳號，兩種使用方式。

$ npm install -g @nolgia/cli

取得存取權杖連接 AI 代理

一名穿白色皮草大衣的年輕女子坐在夜晚停車場裡一疊老電視上，在腿上的鍵盤打字，每個螢幕都映著她身後燃燒的棕櫚樹

安裝

挑選你的套件管理工具。

一個執行檔，四種取得方式。所有管道都提供同一個版本。

$ npm install -g @nolgia/cli

安裝適用你平台的預先建置執行檔。需要 Node 18 以上版本。

$ brew install nolgiainc/nolgia/nolgia

適用 macOS 與 Linux。追蹤最新的標記版本。

$ cargo install nolgia-cli

使用穩定版 Rust 工具鏈從原始碼建置。

$ curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash

自動偵測你的作業系統與架構，再把執行檔放進你的 PATH。

把這段貼給你的 AI 代理

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.

你的 AI 程式設計代理會在不需要 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-only

$ nolgia gen video --model veo-3.1 --prompt "…" --cost-only

API 的 POST /jobs/cost 也會回傳相同的數字。

為長駐終端機的人打造。

不必盯著儀表板。Studio 能做的每件事，一道指令或一次工具呼叫就能完成。

人與 AI 代理共用的用戶端

終端機與 MCP 伺服器背後是同一個平台。你可以自己寫腳本，也可以交給 Claude Code 操作，能力完全相同。

透明的點數計價

在任何生成指令加上 --cost-only，花點數前就能先拿到預估。沒有意外計費，也沒有隱藏倍率。

非同步任務模型

每次生成都是一個可以等待或輪詢的任務。一次送出一批，去忙別的，等成果出來再回來收。

原生多鏡頭序列

用重複的 --shot 旗標組出電影感序列。一道指令就能安排全景、中景與特寫的節奏。

處處皆可圖片轉影片

用一套一致的旗標，在所有支援的模型上由靜態圖片生成影片。

可在 Claude Code 中使用

用 Bearer 權杖把任何 MCP 用戶端指向託管伺服器，所有工具就會出現在你的 AI 代理中。

MCP 伺服器

把整個平台交給你的 AI 代理。

NOLGIA MCP 伺服器託管於 https://mcp.nolgia.ai/mcp，使用 MCP Streamable HTTP 傳輸。以 Bearer PAT 或 JWT 驗證後，全部 81 項工具都能在 Claude Code、Cursor 或任何能傳送標頭的 MCP 用戶端中使用。改用登入而非權杖的助理，請參閱 MCP 頁面。

{
  "mcpServers": {
    "nolgia": {
      "url": "https://mcp.nolgia.ai/mcp",
      "headers": {
        "Authorization": "Bearer nol_your_token_here"
      }
    }
  }
}

從你的帳號產生個人存取權杖，再把它放進 Authorization 標頭。重新啟動用戶端即可載入伺服器。

81 項工具，直接讀取自伺服器本身的工具清單

Generate

Generate: 17 項工具
工具	用途
`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

Your library: 25 項工具
工具	用途
`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

Projects: 11 項工具
工具	用途
`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

Edit sessions and tweaks: 6 項工具
工具	用途
`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

Presets: 2 項工具
工具	用途
`nolgia_list_presets`	List presets
`nolgia_get_preset`	Get one preset

Timelines

Timelines: 4 項工具
工具	用途
`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

Desktop apps: 11 項工具
工具	用途
`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

Models, account and jobs: 5 項工具
工具	用途
`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

模型

CLI 會使用的模型。

影片

Wan 3.0

起價 14 點點每段 5 秒片段

查看模型

影片

Hailuo 3

起價 37 點點每段 5 秒片段

查看模型

影片

Seedance 2.5

起價 26 點點每段 5 秒片段

查看模型

圖片

GPT Image 2.5 Sunburst

起價 8 點點每張圖片

查看模型

圖片

Nano Banana 2.1

起價 4 點點每張圖片

查看模型

圖片

Grok Imagine 2.0

起價 4 點點每張圖片

查看模型

音訊

ElevenLabs v3 Conversational

起價 3 點點每 1,000 字元

查看模型

音訊

Lyria 3.5

起價 5 點點每次生成

查看模型

探索所有模型

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 或其他 AI 代理？: 將你的 MCP 用戶端指向 https://mcp.nolgia.ai/mcp，並在 Authorization: Bearer 標頭中帶上個人存取權杖，全部 81 項工具就會出現在你的 AI 代理中。
CLI 和 App 共用點數嗎？: 用 nolgia auth login 登入時會共用：CLI 跟 App 一樣，先扣每月方案點數，再扣加值點數。個人存取權杖（NOLGIA_TOKEN，API 與 MCP 伺服器也使用它）只會扣加值點數。透過 OAuth 連接的助理（例如 ChatGPT 或 Claude）扣點方式與 App 相同。
我的 AI 程式設計代理能幫我設定 CLI 嗎？: 可以。複製「Paste this into your agent」底下那一行指示。它會引導你的 AI 程式設計代理前往 https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md 的安裝手冊，逐步完成安裝、驗證、技能設定與一次測試生成。
如何查看任務的費用？: 在 CLI 使用 --cost-only，或在 API 使用 POST /jobs/cost。兩者使用相同的計價器，會在生成前回傳相同的預估點數。

連接 AI 代理。

建立帳號、產生權杖，再把你的 CLI 或 MCP 用戶端指向 NOLGIA。第一批點數由我們請客。

免費開始查看定價