API Reference
API reference
On this page
Everything Nolgia does is one HTTP API. The clients, the CLI and the MCP server are all wrappers over the same endpoints, so anything you can do in one you can do in all of them.
Which one should I use #
| If you are | Use | Start here |
|---|---|---|
| Writing a script or a backend in TypeScript | @nolgia/sdk |
Client libraries |
| Writing Python | nolgia |
Client libraries |
| Working in a terminal, or in CI | The CLI | The CLI |
| Using a coding agent (Claude Code, Cursor, Codex) | The MCP server | Run MCP |
| In another language, or want no dependency at all | REST directly | Browse the endpoints |
If you are not sure, start with REST. Every example on this site shows a curl call beside the language tabs, so you can always see exactly what goes over the wire.
REST #
| Environment | Base URL |
|---|---|
| Production | https://api.nolgia.ai/v1 |
| Staging | https://api.stg.nolgia.ai/v1 |
| Local development | http://localhost:8080/v1 |
The full reference is generated from the same OpenAPI document the server validates against, so it can never describe an endpoint we do not serve: browse the endpoints or download openapi.yaml and generate your own client.
Authentication is a bearer token on every request. See Authentication for how to create one, and Errors for the shape of a failure.
Client libraries #
| Client | Package | Version |
|---|---|---|
| TypeScript | @nolgia/sdk |
0.1.4 |
| Python | nolgia on PyPI |
0.1.4 |
| Rust | nolgia-client |
published with the CLI release; see crates.io |
Both published clients are generated from the OpenAPI document, so their types move when the spec moves. Client libraries has installation and a first call in each.
CLI #
From nolgia --help in release 0.2.30, published 2026-09-21:
The CLI signs in once and then generates from a terminal or a CI job. The CLI covers install, nolgia auth login and the generate commands.
MCP server #
The MCP server exposes the same API as tools a coding agent can call directly, grouped by what they do. Run MCP lists every tool and has the install snippets for Claude Code, Cursor and Codex.
Models #
Every model, with what it costs and what it can do, is generated from the live catalog:
| Image | Video | Audio | 3D |
|---|---|---|---|
| 48 | 74 | 17 | 2 |
Browse them by what you want to make — image generation, image editing, text to video, image to video, audio and speech, restore and upscale, utilities or 3D.
Reading this reference from an agent #
Every page here is also served as Markdown at the same path with a .md extension, and the whole site is concatenated at llms-full.txt. Agent-readable surfaces lists all of them.