如何安装 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 与应用一样，先消耗每月套餐积分，再消耗充值积分。个人访问令牌（NOLGIA_TOKEN，API 和 MCP 服务器也使用它）只消耗充值积分。通过 OAuth 连接的助手（如 ChatGPT 或 Claude）扣费方式与应用相同。

我的编程智能体能帮我配置 CLI 吗？

可以。复制“粘贴到你的智能体”下方的一行指令。它会引导你的编程智能体使用 https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md 上的安装手册，手册会逐步完成安装、认证、技能配置和一次验证生成。

如何查看任务的费用？

在 CLI 中使用 --cost-only，或在 API 中调用 POST /jobs/cost。两者使用同一个计价器，在你生成之前返回相同的积分估算。

CLI 与 MCP 服务器

在终端生成，或者让你的智能体来生成。

nolgia CLI 是一个用于图片、视频和音频生成的单一 Rust 二进制文件。NOLGIA MCP 服务器把同一个平台开放给 Claude Code 和其他任何智能体。一个账户，两种接入方式。

$ npm install -g @nolgia/cli

获取访问令牌连接智能体

夜晚的停车场里，一位身穿白色皮草大衣的年轻女子坐在一堆旧电视机上，敲着腿上的键盘，每块屏幕都映出她身后燃烧的棕榈树

安装

选择你的包管理器。

一个二进制文件，四种获取方式。所有渠道同步同一个版本。

$ 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 中。

粘贴到你的智能体

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-only

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

API 的 POST /jobs/cost 返回相同的数字。

为离不开终端的人打造。

不用一直盯着控制台。Studio 能做的一切，一条命令或一次工具调用就能完成。

人与智能体共用的客户端

终端和 MCP 服务器背后是同一个平台。你可以手写脚本，也可以让 Claude Code 来驱动，能力完全相同。

透明的积分计价

在任意生成命令中加上 --cost-only，花费之前先拿到积分估算。没有意外计费，没有隐藏倍率。

异步任务模型

每次生成都是一个可以等待或轮询的任务。批量提交后就可以去忙别的，等结果出来再来收取。

原生多镜头序列

多次使用 --shot 参数，组合出电影感序列。一条命令就能安排全景、中景和特写镜头。

图生视频，处处可用

在所有支持的模型上，用同一套参数从静态图片生成视频。

支持 Claude Code

用 Bearer 令牌把任意 MCP 客户端指向托管服务器，全部工具就会出现在你的智能体中。

MCP 服务器

把整个平台交给你的智能体。

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 或其他智能体？: 将你的 MCP 客户端指向 https://mcp.nolgia.ai/mcp，并在 Authorization: Bearer 请求头中携带个人访问令牌，全部 81 个工具就会出现在你的智能体中。
CLI 和应用共用积分吗？: 使用 nolgia auth login 登录时，是的：CLI 与应用一样，先消耗每月套餐积分，再消耗充值积分。个人访问令牌（NOLGIA_TOKEN，API 和 MCP 服务器也使用它）只消耗充值积分。通过 OAuth 连接的助手（如 ChatGPT 或 Claude）扣费方式与应用相同。
我的编程智能体能帮我配置 CLI 吗？: 可以。复制“粘贴到你的智能体”下方的一行指令。它会引导你的编程智能体使用 https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md 上的安装手册，手册会逐步完成安装、认证、技能配置和一次验证生成。
如何查看任务的费用？: 在 CLI 中使用 --cost-only，或在 API 中调用 POST /jobs/cost。两者使用同一个计价器，在你生成之前返回相同的积分估算。

连接智能体。

创建账户，生成令牌，然后把你的 CLI 或 MCP 客户端指向 NOLGIA。首批积分我们请客。

开始使用 · 免费查看价格