Portale sviluppatori

Sviluppa su NOLGIA.

Una sola API REST per generare immagini, video e audio, con guide, SDK ufficiali in quattro linguaggi, una CLI e skill per agenti di coding. URL di base https://api.nolgia.ai, con autenticazione tramite token di accesso personale.

Un giovane scrive al portatile su un banco di scuola in un backlot deserto mentre alle sue spalle una gru cala in posizione la facciata a grandezza naturale di un edificio

Riferimento API

Sempre aggiornata, generata dal contratto OpenAPI.

Ogni endpoint, schema ed esempio resta allineato alla specifica su cui si basa la piattaforma. Esplorala, poi autenticati con un token di accesso personale.

Documentazione API

Il riferimento OpenAPI completo: endpoint di generazione, asset, job, fatturazione e account, con gli schemi di richiesta e risposta.

docs.nolgia.ai
Lock

Autenticazione

Le richieste portano un token di accesso personale (PAT) come bearer token. Generane uno con una POST a /pat con un nome. Il token in chiaro (con prefisso nol_) viene restituito una sola volta, quindi conservalo in modo sicuro.

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

Poi invialo come Authorization: Bearer nol_… in ogni richiesta. Un PAT consuma solo i crediti di ricarica, mai i crediti mensili del piano, e i modelli che richiedono Pro o superiore richiedono comunque quel piano.

Terminal window

CLI

Installa la CLI nolgia.

Un solo binario Rust per immagini, video e audio dal tuo terminale. Ogni metodo qui sotto installa la stessa release.

Homebrew

shell
brew tap nolgiainc/nolgia && brew install nolgia

macOS e Linux. La formula nolgia in nolgiainc/homebrew-nolgia segue l'ultima release.

npm

shell
npm install -g @nolgia/cli

Richiede Node 18 o successivo. Scarica il binario precompilato per la tua piattaforma durante il postinstall.

Installer da shell

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

Questo comando esegue uno script scaricato dal branch main del repository e poi scarica il binario di una release. Se il tuo ambiente richiede revisioni o controlli di provenienza, salva e controlla prima install.sh e fissa la versione del binario con --tag.

Cargo

shell
cargo install nolgia-cli

Compila dal sorgente con una toolchain Rust stabile.

Binari delle release

Binari precompilati per ogni piattaforma nella release su 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
Ultima release su GitHub
Riferimento completo della CLI
Agent core with orbiting tasks

Skill e plugin

Insegna NOLGIA al tuo agente di coding.

Tre skill, pubblicate su nolgiainc/nolgia-skills, insegnano a Claude Code, Cursor e Codex la piattaforma, il prompting video e gli spot UGC. Scegli il metodo di installazione che usa il tuo agente.

Qualsiasi agente

shell
npx skills add nolgiainc/nolgia-skills

Richiede Node.js. La CLI skills rileva Claude Code, Cursor, Codex e gli altri agenti supportati.

GitHub CLI

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

GitHub CLI 2.90 o successiva (il comando è in anteprima). Aggiungi --scope user per installarlo in tutti i progetti.

Claude Code

Claude Code
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgia

Digita questi comandi in Claude Code. Registra /nolgia:nolgia-platform, /nolgia:nolgia-video-prompting e /nolgia:nolgia-ugc-ads.

Cursor

Il repository delle skill include un manifest per il plugin di Cursor. Il server MCP ospitato e il comando /nolgia arrivano da nolgiainc/cursor-plugin.

nolgiainc/cursor-plugin su GitHub

Codex

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

Codex legge anche il manifest del plugin Codex del repository quando è installato come plugin.

Dalla CLI nolgia

shell
nolgia skills install

La CLI include le stesse tre skill. Destinazioni: --target claude-user, --target claude-project, --target hermes, oppure --target dir --dir <path>.

Incolla questo nel tuo agente

una riga
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.

Il tuo agente di coding installa la CLI senza sudo, aspetta che ti autentichi, installa le skill ed esegue una generazione di verifica.

Leggi il runbook
Guida all'installazione e sorgente su GitHub
Library of tiles

SDK ufficiali

Quattro client, una piattaforma.

Installa il client per il tuo stack e inizia a generare in pochi minuti. Ogni SDK usa la stessa API.

Python

PyPI · nolgia

Client tipizzato generato dal contratto OpenAPI. Importa AuthenticatedClient e chiama i moduli nolgia.api.*.

shell
pip install nolgia

JavaScript / TypeScript

npm · @nolgia/sdk

Client openapi-fetch completamente tipizzato per Node e il browser. Una sola installazione porta tutto ciò che serve. Distribuito come ESM con definizioni TypeScript di prima classe.

shell
npm install @nolgia/sdk

Rust

crates.io · nolgia

Client asincrono su tokio, generato dal contratto OpenAPI, con tentativi ripetuti, errori tipizzati, attesa dei job, caricamenti e download integrati. Una sola installazione: riesporta il suo runtime e serde_json. Un client bloccante è a un feature flag di distanza.

shell
cargo add nolgia

Rust CLI

crates.io · nolgia-cli

Il comando nolgia: un solo binario Rust che genera immagini, video e audio dal tuo terminale. Per il codice Rust, usa il crate nolgia qui sopra.

shell
cargo install nolgia-cli

Avvio rapido

Autenticati, poi chiama l'API.

Crea un client con il tuo PAT, invia una generazione di immagine e attendi il job con il long polling per ottenere l'asset: le stesse tre chiamate con cui si apre il README di ogni SDK. Il client Python espone moduli tipizzati nolgia.api.*, subscribe del crate Rust invia e attende in una sola chiamata, e la CLI controlla la piattaforma dalla tua shell.

Un giovane con una giacca sportiva siede tranquillo su una spiaggia con il portatile mentre alle sue spalle si alza un'onda alta come un palazzo, dorata dal sole
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

Ottieni un token e inizia a sviluppare.

Crea un account, genera un token di accesso personale e punta qualsiasi SDK su NOLGIA. I primi crediti li offriamo noi.