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.

Guide
Inizia da una guida.
Impara a usare la piattaforma con le guide su docs.nolgia.ai, oppure genera da Claude o Cursor con MCP.
Avvio rapido
Installa un client ed esegui la tua prima generazione.
Leggi la guidaAutenticazione
Crea un token e autentica le richieste all'API.
Leggi la guidaJob
Invia una generazione e attendi il risultato.
Leggi la guidaCaricamenti
Carica file di riferimento per le tue generazioni.
Leggi la guidaErrori
Capisci gli errori dell'API e come gestirli.
Leggi la guidaFatturazione
Tieni traccia dei crediti e dei costi di generazione.
Leggi la guidaOrganizzazioni
Gestisci gli accessi del team e le risorse condivise.
Leggi la guidaAgent Sessions API
Crea sessioni e invia messaggi al NOLGIA Agent.
Leggi la guidaLibrerie client
Scegli un client ufficiale per il tuo linguaggio.
Leggi la guidaRiferimento API
Esplora ogni endpoint dell'API e ogni schema di richiesta.
Apri il riferimentollms.txt
Leggi l'indice della documentazione in testo semplice per gli agenti di coding.
Apri llms.txtRiferimento 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.
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.
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.
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
brew tap nolgiainc/nolgia && brew install nolgiamacOS e Linux. La formula nolgia in nolgiainc/homebrew-nolgia segue l'ultima release.
npm
npm install -g @nolgia/cliRichiede Node 18 o successivo. Scarica il binario precompilato per la tua piattaforma durante il postinstall.
Installer da shell
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bashQuesto 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
cargo install nolgia-cliCompila 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_64nolgia-aarch64-unknown-linux-gnuLinux arm64nolgia-x86_64-pc-windows-msvc.exeWindows x86_64nolgia-aarch64-pc-windows-msvc.exeWindows arm64
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
npx skills add nolgiainc/nolgia-skillsRichiede Node.js. La CLI skills rileva Claude Code, Cursor, Codex e gli altri agenti supportati.
GitHub CLI
gh skill install nolgiainc/nolgia-skills --allGitHub CLI 2.90 o successiva (il comando è in anteprima). Aggiungi --scope user per installarlo in tutti i progetti.
Claude Code
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgiaDigita 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 GitHubCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope userCodex legge anche il manifest del plugin Codex del repository quando è installato come plugin.
Dalla CLI nolgia
nolgia skills installLa 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
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 runbookSDK 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 · nolgiaClient tipizzato generato dal contratto OpenAPI. Importa AuthenticatedClient e chiama i moduli nolgia.api.*.
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdkClient 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.
npm install @nolgia/sdkRust
crates.io · nolgiaClient 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.
cargo add nolgiaRust CLI
crates.io · nolgia-cliIl 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.
cargo install nolgia-cliAvvio 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.

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)import { createNolgiaClient } from "@nolgia/sdk";
// Create a token at https://nolgia.ai/settings/api-tokens and pass it as a bearer.
const nolgia = createNolgiaClient("nol_...");
// POST /generate/image answers 202 with a job.
const { data: job, error } = await nolgia.POST("/generate/image", {
body: { model: "gpt-image-2", prompt: "a red fox in the snow", num_images: 1 },
});
if (error) throw new Error(`${error.title}: ${error.detail ?? ""}`);
// Long-poll GET /jobs/{id}/wait for the finished asset.
const { data: done } = await nolgia.GET("/jobs/{id}/wait", {
params: { path: { id: job.id }, query: { timeout_seconds: 120 } },
});
if (done?.status === "succeeded") console.log(done.asset?.signed_url);use nolgia::tokio;
#[tokio::main]
async fn main() -> nolgia::Result<()> {
// Create a token at https://nolgia.ai/settings/api-tokens and export it as NOLGIA_API_KEY.
let nolgia = nolgia::Client::from_env()?;
// POST /generate/image answers 202 with a job; subscribe long-polls
// GET /jobs/{id}/wait for the finished asset.
let done = nolgia.subscribe(nolgia::image("gpt-image-2", "a red fox in the snow")).await?;
nolgia.download(done.url().expect("an image"), "fox.png").await?;
Ok(())
}# Authenticate once: device login in your browser.
nolgia auth login
# Generate an image from a prompt.
nolgia gen image \
--prompt "a serene mountain lake at dawn" \
--out lake.pngSviluppa su NOLGIA
Più di un'API.
Collega la piattaforma al tuo assistente tramite MCP, estendi il tuo agente con le Abilities del Marketplace, oppure lascia che sia il NOLGIA Agent a generare per te.
NOLGIA MCP
Aggiungi NOLGIA a Claude Code o Cursor e genera direttamente dal tuo assistente.
Collega il tuo assistenteMarketplace · Abilities
Installa Abilities pronte che aggiungono nuove competenze al tuo agente e ai tuoi workflow.
Sfoglia il MarketplaceAgent Sessions API
Controlla il NOLGIA Agent dal tuo codice: sessioni, messaggi, streaming, indirizzamento, interruzione e domande, con helper di esecuzione in ogni SDK.
Leggi la guida all'API Agent SessionsIl NOLGIA Agent
Un agente ospitato che usa la stessa API: descrivi l'inquadratura e lui genera.
Scopri l'AgentOttieni 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.

