开发者门户

基于 NOLGIA 构建。

一套用于图片、视频和音频生成的 REST API,配有开发指南、四种语言的官方 SDK、CLI 以及编程智能体技能。基础 URL 为 https://api.nolgia.ai,使用个人访问令牌认证。

空荡荡的片厂外景地上,一个年轻人坐在课桌前用笔记本电脑打字,身后一台起重机正把一整面实景大小的建筑立面吊装到位

API 参考

实时更新,由 OpenAPI 契约生成。

每个端点、Schema 和示例都与驱动平台的规范保持同步。先浏览一遍,再用个人访问令牌进行认证。

API 文档

完整的 OpenAPI 参考:生成、素材、任务、计费和账户端点,附请求和响应 Schema。

docs.nolgia.ai
Lock

认证

请求以 Bearer 令牌形式携带个人访问令牌(PAT)。向 /pat 发送带名称的 POST 请求即可生成。明文令牌(前缀为 nol_)只返回一次,请妥善保存。

shell
curl -X POST https://api.nolgia.ai/pat -d '{"name":"my-cli"}'

然后在每个请求中以 Authorization: Bearer nol_… 发送。PAT 只消耗充值积分,从不消耗每月套餐积分,需要 Pro 或更高套餐的模型仍然需要相应套餐。

Terminal window

CLI

安装 nolgia CLI。

一个 Rust 二进制文件,在终端生成图片、视频和音频。下面每种方式安装的都是同一个版本。

Homebrew

shell
brew tap nolgiainc/nolgia && brew install nolgia

适用于 macOS 和 Linux。nolgiainc/homebrew-nolgia 中的 nolgia formula 跟随最新版本。

npm

shell
npm install -g @nolgia/cli

需要 Node 18 或更高版本。会在 postinstall 阶段下载适用于你平台的预编译二进制文件。

Shell 安装脚本

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

该命令会运行从仓库 main 分支获取的脚本,然后下载发布版二进制文件。如果你的环境要求审查或来源校验,请先保存并检查 install.sh,再用 --tag 固定二进制版本。

Cargo

shell
cargo install nolgia-cli

使用稳定版 Rust 工具链从源码构建。

发布版二进制文件

GitHub 发布页提供各平台的预编译二进制文件:

  • nolgia-x86_64-apple-darwinmacOS (universal)
  • nolgia-x86_64-unknown-linux-gnuLinux x86_64
  • nolgia-aarch64-unknown-linux-gnuLinux arm64
  • nolgia-x86_64-pc-windows-msvc.exeWindows x86_64
  • nolgia-aarch64-pc-windows-msvc.exeWindows arm64
GitHub 上的最新版本
完整 CLI 参考
Agent core with orbiting tasks

技能和插件

让你的编程智能体学会 NOLGIA。

发布在 nolgiainc/nolgia-skills 的三个技能,教会 Claude Code、Cursor 和 Codex 使用平台、编写视频提示词和制作 UGC 广告。选择你的智能体使用的安装方式。

任意智能体

shell
npx skills add nolgiainc/nolgia-skills

需要 Node.js。skills CLI 会检测 Claude Code、Cursor、Codex 和其他受支持的智能体。

GitHub CLI

shell
gh skill install nolgiainc/nolgia-skills --all

需要 GitHub CLI 2.90 或更高版本(该命令处于预览阶段)。加上 --scope user 可为所有项目安装。

Claude Code

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

Codex

shell
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope user

以插件方式安装时,Codex 还会读取该仓库的 Codex 插件清单。

通过 nolgia CLI

shell
nolgia skills install

CLI 内置同样的三个技能。目标:--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,等你完成认证后安装技能,并运行一次验证生成。

阅读安装手册
GitHub 上的安装指南和源码
Library of tiles

官方 SDK

四个客户端,一个平台。

安装适合你技术栈的客户端,几分钟内就能开始生成。每个 SDK 面向的都是同一套 API。

Python

PyPI · nolgia

由 OpenAPI 契约生成的类型化客户端。导入 AuthenticatedClient,然后调用 nolgia.api.* 模块。

shell
pip install nolgia

JavaScript / TypeScript

npm · @nolgia/sdk

适用于 Node 和浏览器、完全类型化的 openapi-fetch 客户端。一次安装即包含所需的一切。以 ESM 发布,并提供完善的 TypeScript 类型定义。

shell
npm install @nolgia/sdk

Rust

crates.io · nolgia

基于 tokio 的异步客户端,由 OpenAPI 契约生成,内置重试、类型化错误、任务等待、上传和下载。一次安装即可:它会重新导出自身的运行时和 serde_json。开启一个 feature 开关即可使用阻塞式客户端。

shell
cargo add nolgia

Rust CLI

crates.io · nolgia-cli

nolgia 命令:一个在终端生成图片、视频和音频的单一 Rust 二进制文件。如需在 Rust 代码中使用,请用上面的 nolgia crate。

shell
cargo install nolgia-cli

快速入门

先认证,再调用。

用你的 PAT 创建客户端,提交一次图片生成,再对任务进行长轮询以获取素材:每个 SDK 的 README 开头都是这三个调用。Python 客户端提供类型化的 nolgia.api.* 模块,Rust crate 的 subscribe 一次调用即可提交并等待,CLI 则让你在 shell 中驱动整个平台。

一个穿运动夹克的年轻人带着笔记本电脑平静地坐在海滩上,身后一道楼房高的巨浪涌起,被阳光染成金色
quickstart.py
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)
Lock

拿到令牌,开始构建。

创建账户,生成个人访问令牌,然后把任意 SDK 指向 NOLGIA。首批积分我们请客。