API 参考
实时更新,由 OpenAPI 契约生成。
每个端点、Schema 和示例都与驱动平台的规范保持同步。先浏览一遍,再用个人访问令牌进行认证。
API 文档
完整的 OpenAPI 参考:生成、素材、任务、计费和账户端点,附请求和响应 Schema。
认证
请求以 Bearer 令牌形式携带个人访问令牌(PAT)。向 /pat 发送带名称的 POST 请求即可生成。明文令牌(前缀为 nol_)只返回一次,请妥善保存。
curl -X POST https://api.nolgia.ai/pat -d '{"name":"my-cli"}'然后在每个请求中以 Authorization: Bearer nol_… 发送。PAT 只消耗充值积分,从不消耗每月套餐积分,需要 Pro 或更高套餐的模型仍然需要相应套餐。
CLI
安装 nolgia CLI。
一个 Rust 二进制文件,在终端生成图片、视频和音频。下面每种方式安装的都是同一个版本。
Homebrew
brew tap nolgiainc/nolgia && brew install nolgia适用于 macOS 和 Linux。nolgiainc/homebrew-nolgia 中的 nolgia formula 跟随最新版本。
npm
npm install -g @nolgia/cli需要 Node 18 或更高版本。会在 postinstall 阶段下载适用于你平台的预编译二进制文件。
Shell 安装脚本
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash该命令会运行从仓库 main 分支获取的脚本,然后下载发布版二进制文件。如果你的环境要求审查或来源校验,请先保存并检查 install.sh,再用 --tag 固定二进制版本。
Cargo
cargo install nolgia-cli使用稳定版 Rust 工具链从源码构建。
发布版二进制文件
GitHub 发布页提供各平台的预编译二进制文件:
nolgia-x86_64-apple-darwinmacOS (universal)nolgia-x86_64-unknown-linux-gnuLinux x86_64nolgia-aarch64-unknown-linux-gnuLinux arm64nolgia-x86_64-pc-windows-msvc.exeWindows x86_64nolgia-aarch64-pc-windows-msvc.exeWindows arm64
技能和插件
让你的编程智能体学会 NOLGIA。
发布在 nolgiainc/nolgia-skills 的三个技能,教会 Claude Code、Cursor 和 Codex 使用平台、编写视频提示词和制作 UGC 广告。选择你的智能体使用的安装方式。
任意智能体
npx skills add nolgiainc/nolgia-skills需要 Node.js。skills CLI 会检测 Claude Code、Cursor、Codex 和其他受支持的智能体。
GitHub CLI
gh skill install nolgiainc/nolgia-skills --all需要 GitHub CLI 2.90 或更高版本(该命令处于预览阶段)。加上 --scope user 可为所有项目安装。
Claude Code
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgia在 Claude Code 中输入这些命令,将注册 /nolgia:nolgia-platform、/nolgia:nolgia-video-prompting 和 /nolgia:nolgia-ugc-ads。
Cursor
技能仓库附带 Cursor 插件清单。托管 MCP 服务器和 /nolgia 命令来自 nolgiainc/cursor-plugin。
GitHub 上的 nolgiainc/cursor-pluginCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope user以插件方式安装时,Codex 还会读取该仓库的 Codex 插件清单。
通过 nolgia CLI
nolgia skills installCLI 内置同样的三个技能。目标:--target claude-user、--target claude-project、--target hermes,或 --target dir --dir <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,等你完成认证后安装技能,并运行一次验证生成。
阅读安装手册官方 SDK
四个客户端,一个平台。
安装适合你技术栈的客户端,几分钟内就能开始生成。每个 SDK 面向的都是同一套 API。
Python
PyPI · nolgia由 OpenAPI 契约生成的类型化客户端。导入 AuthenticatedClient,然后调用 nolgia.api.* 模块。
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdk适用于 Node 和浏览器、完全类型化的 openapi-fetch 客户端。一次安装即包含所需的一切。以 ESM 发布,并提供完善的 TypeScript 类型定义。
npm install @nolgia/sdkRust
crates.io · nolgia基于 tokio 的异步客户端,由 OpenAPI 契约生成,内置重试、类型化错误、任务等待、上传和下载。一次安装即可:它会重新导出自身的运行时和 serde_json。开启一个 feature 开关即可使用阻塞式客户端。
cargo add nolgiaRust CLI
crates.io · nolgia-clinolgia 命令:一个在终端生成图片、视频和音频的单一 Rust 二进制文件。如需在 Rust 代码中使用,请用上面的 nolgia crate。
cargo install nolgia-cli快速入门
先认证,再调用。
用你的 PAT 创建客户端,提交一次图片生成,再对任务进行长轮询以获取素材:每个 SDK 的 README 开头都是这三个调用。Python 客户端提供类型化的 nolgia.api.* 模块,Rust crate 的 subscribe 一次调用即可提交并等待,CLI 则让你在 shell 中驱动整个平台。

from nolgia import AuthenticatedClient
from nolgia.api.generate import generate_image
from nolgia.api.jobs import wait_for_job
from nolgia.models import GenerateImageRequest, ImageModel, Job
# Create a token at https://nolgia.ai/settings/api-tokens and pass it as a bearer.
client = AuthenticatedClient(base_url="https://api.nolgia.ai/v1", token="nol_...")
# POST /generate/image answers 202 with a job.
job = generate_image.sync(
client=client,
body=GenerateImageRequest(model=ImageModel.GPT_IMAGE_2, prompt="a red fox in the snow"),
)
if not isinstance(job, Job):
raise SystemExit(f"refused: {job}")
# Long-poll GET /jobs/{id}/wait for the finished asset.
done = wait_for_job.sync(job.id, client=client, timeout_seconds=120)
if isinstance(done, Job) and done.status == "succeeded":
print(done.asset.signed_url)import { createNolgiaClient } from "@nolgia/sdk";
// Create a token at https://nolgia.ai/settings/api-tokens and pass it as a bearer.
const nolgia = createNolgiaClient("nol_...");
// POST /generate/image answers 202 with a job.
const { data: job, error } = await nolgia.POST("/generate/image", {
body: { model: "gpt-image-2", prompt: "a red fox in the snow", num_images: 1 },
});
if (error) throw new Error(`${error.title}: ${error.detail ?? ""}`);
// Long-poll GET /jobs/{id}/wait for the finished asset.
const { data: done } = await nolgia.GET("/jobs/{id}/wait", {
params: { path: { id: job.id }, query: { timeout_seconds: 120 } },
});
if (done?.status === "succeeded") console.log(done.asset?.signed_url);use nolgia::tokio;
#[tokio::main]
async fn main() -> nolgia::Result<()> {
// Create a token at https://nolgia.ai/settings/api-tokens and export it as NOLGIA_API_KEY.
let nolgia = nolgia::Client::from_env()?;
// POST /generate/image answers 202 with a job; subscribe long-polls
// GET /jobs/{id}/wait for the finished asset.
let done = nolgia.subscribe(nolgia::image("gpt-image-2", "a red fox in the snow")).await?;
nolgia.download(done.url().expect("an image"), "fox.png").await?;
Ok(())
}# Authenticate once: device login in your browser.
nolgia auth login
# Generate an image from a prompt.
nolgia gen image \
--prompt "a serene mountain lake at dawn" \
--out lake.png基于 NOLGIA 构建
不只是 API。
通过 MCP 把平台连接到你自己的助手,用市场中的能力扩展你的智能体,或者让 NOLGIA Agent 替你运行生成。


