# Nolgia API

> One REST API for image, video and audio generation: the same API behind nolgia.ai, the `nolgia` CLI, the MCP server and the NOLGIA Agent. Base URL https://api.nolgia.ai/v1 (staging https://api.stg.nolgia.ai/v1). Authenticate with a Personal Access Token (`Authorization: Bearer nol_...`). Generation endpoints answer 202 with a job; long-poll GET /jobs/{id}/wait for the asset. Errors are RFC 7807 problem objects.

## Docs

- [Getting started](https://docs.nolgia.ai/guides/getting-started.html): install, authenticate, first image, first video, the job model, credits (hold then settle), uploads, errors, client libraries. Markdown source: https://docs.nolgia.ai/guides/getting-started.md
- [Agent Sessions API guide](https://docs.nolgia.ai/guides/agent-api.html): sessions, messages, streaming, steering, interrupt, questions, credits and SDK run helpers. Markdown source: https://docs.nolgia.ai/guides/agent-api.md
- [API reference](https://docs.nolgia.ai/api/): every endpoint and schema, rendered from the spec
- [OpenAPI spec](https://docs.nolgia.ai/api/openapi.yaml): the canonical contract, OpenAPI 3.0
- [Public price list](https://api.nolgia.ai/v1/pricing/models): per-model credit costs, no token required

## Clients

- Python: `pip install nolgia` (https://pypi.org/project/nolgia/)
- TypeScript: `npm install @nolgia/sdk openapi-fetch` (https://www.npmjs.com/package/@nolgia/sdk)
- Go: import path github.com/nolgiainc/nolgia-api/sdk/go (private repository; needs GOPRIVATE and repo access)
- Rust CLI: `cargo install nolgia-cli` (https://crates.io/crates/nolgia-cli), docs at https://nolgia.ai/cli
- MCP server for Claude Code and Cursor: https://nolgia.ai/mcp

## Product

- [Developer portal](https://nolgia.ai/developers)
- [Pricing](https://nolgia.ai/pricing)
- [The NOLGIA Agent](https://nolgia.ai/nolgia-agent)
- [Presets](https://nolgia.ai/presets)