Developer Portal
Build on NOLGIA.
One REST API for image, video and audio generation, with guides, official SDKs in four languages, a CLI and skills for coding agents. Base URL https://api.nolgia.ai, authenticated with a Personal Access Token.
Guides
Start with a guide.
Read the guides on docs.nolgia.ai, or the developer recipes on this site.
Getting started
Install a client, mint a token, run your first image and video, and learn the job model, credits, uploads and errors.
Read the guideAgent Sessions API
Sessions, messages, streaming, steering, interrupt, questions and the SDK run helpers.
Read the guideAPI reference
Every endpoint and schema, rendered from the OpenAPI contract. Try requests from the page.
Open the referencellms.txt
A plain-text index of the docs for AI assistants and coding agents.
Open llms.txtDeveloper guides
Recipes on this site, like running a preset from your own code, with live costs.
Browse developer guidesAPI reference
Live, generated from the OpenAPI contract.
Every endpoint, schema, and example stays in lockstep with the spec that powers the platform. Explore it, then authenticate with a Personal Access Token.
API documentation
The full OpenAPI reference: generation, assets, jobs, billing, and account endpoints, with request and response schemas.
Authentication
Requests carry a Personal Access Token (PAT) as a bearer token. Mint one by POSTing to /pat with a name. The plaintext token (prefixed nol_) is returned once, so store it securely.
curl -X POST https://api.nolgia.ai/pat -d '{"name":"my-cli"}'Then send it as Authorization: Bearer nol_… on every request. PAT access uses credits from your shared top-up pool and is not gated by subscription tier.
CLI
Install the nolgia CLI.
One Rust binary for image, video and audio from your terminal. Every path below installs the same release.
Homebrew
brew tap nolgiainc/nolgia && brew install nolgiamacOS and Linux. The nolgia formula in nolgiainc/homebrew-nolgia tracks the latest release.
npm
npm install -g @nolgia/cliRequires Node 18 or newer. Downloads the prebuilt binary for your platform during postinstall.
Shell installer
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bashThis command runs a script fetched from the repository's main branch and then downloads a release binary. If your environment requires review or provenance checks, save and inspect install.sh first and pin the binary with --tag.
Cargo
cargo install nolgia-cliBuilds from source with a stable Rust toolchain.
Release binaries
Prebuilt binaries for every platform on the GitHub release:
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
Skills and plugins
Teach your coding agent NOLGIA.
Three skills, published at nolgiainc/nolgia-skills, teach Claude Code, Cursor and Codex the platform, video prompting and UGC ads. Pick the install path your agent uses.
Any agent
npx skills add nolgiainc/nolgia-skillsRequires Node.js. The skills CLI detects Claude Code, Cursor, Codex and other supported agents.
GitHub CLI
gh skill install nolgiainc/nolgia-skills --allGitHub CLI 2.90 or newer (the command is in preview). Add --scope user to install for every project.
Claude Code
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgiaType these commands inside Claude Code. Registers /nolgia:nolgia-platform, /nolgia:nolgia-video-prompting and /nolgia:nolgia-ugc-ads.
Cursor
The skills repo ships a Cursor plugin manifest. The hosted MCP server plus a /nolgia command come from nolgiainc/cursor-plugin.
nolgiainc/cursor-plugin on GitHubCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope userCodex also reads the repo's Codex plugin manifest when installed as a plugin.
From the nolgia CLI
nolgia skills installThe CLI bundles the same three skills. Targets: --target claude-user, --target claude-project, --target hermes, or --target dir --dir <path>.
Official SDKs
Four clients, one platform.
Install the client for your stack and start generating in minutes. Each SDK targets the same API surface.
Python
PyPI · nolgiaTyped client generated from the OpenAPI contract. Import AuthenticatedClient and call the nolgia.api.* modules.
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdkFully typed openapi-fetch client for Node and the browser (openapi-fetch is a peer dependency). Ships ESM with first-class TypeScript definitions.
npm install @nolgia/sdk openapi-fetchGo
Module · sdk/goIdiomatic Go client (package nolgia) generated with oapi-codegen. Construct it with nolgia.New(token). Lives in the private nolgia-api repository today, so go get needs GOPRIVATE and repository access.
go get github.com/nolgiainc/nolgia-api/sdk/goRust CLI
crates.io · nolgia-cliThe nolgia command: a single Rust binary that generates image, video, and audio from your terminal. Built on the nolgia-client crate.
cargo install nolgia-cliQuickstart
Authenticate, then call.
Create a client with your PAT, submit an image generation and long-poll the job for the asset: the same three calls each SDK README opens with. The Python client exposes typed nolgia.api.* modules; the CLI drives the platform from your 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.com/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)Build on NOLGIA
More than an API.
Connect the platform to your own assistant over MCP, extend your agent with abilities from the Marketplace, or let the NOLGIA Agent run the generation for you.
NOLGIA MCP
Add NOLGIA to Claude Code or Cursor and generate from inside your own assistant.
Connect your assistantMarketplace · Abilities
Install ready-made abilities that plug new skills into your agent and workflows.
Browse the MarketplaceAgent Sessions API
Drive the NOLGIA Agent from your own code: sessions, messages, streaming, steering, interrupt and questions, with run helpers in every SDK.
Read the Agent Sessions API guideThe NOLGIA Agent
A hosted agent that drives the same API: describe the shot, and it generates.
Meet the AgentGet a token, start building.
Create an account, mint a Personal Access Token, and point any SDK at NOLGIA. The first credits are on us.

