Entwicklerportal
Entwickle mit NOLGIA.
Eine REST API für die Generierung von Bild, Video und Audio, mit Anleitungen, offiziellen SDKs in vier Sprachen, einer CLI und Skills für Coding-Agenten. Basis-URL https://api.nolgia.ai, authentifiziert mit einem Personal Access Token.

Anleitungen
Starte mit einer Anleitung.
Lerne die Plattform mit den Anleitungen auf docs.nolgia.ai kennen oder generiere über MCP aus Claude oder Cursor.
Schnellstart
Installiere einen Client und starte deine erste Generierung.
Anleitung lesenAuthentifizierung
Erstelle ein Token und authentifiziere API-Anfragen.
Anleitung lesenJobs
Sende eine Generierung ab und warte auf ihr Ergebnis.
Anleitung lesenUploads
Lade Referenzdateien für deine Generierungen hoch.
Anleitung lesenFehler
Verstehe API-Fehler und wie du mit ihnen umgehst.
Anleitung lesenAbrechnung
Behalte Credits und Generierungskosten im Blick.
Anleitung lesenOrganisationen
Verwalte Teamzugriffe und gemeinsame Ressourcen.
Anleitung lesenAgent Sessions API
Erstelle Sitzungen und sende Nachrichten an den NOLGIA Agent.
Anleitung lesenClient-Bibliotheken
Wähle einen offiziellen Client für deine Sprache.
Anleitung lesenAPI-Referenz
Erkunde jeden API-Endpunkt und jedes Anfrageschema.
Referenz öffnenllms.txt
Lies den Doku-Index im Klartext für Coding-Agenten.
llms.txt öffnenAPI-Referenz
Live, generiert aus dem OpenAPI-Vertrag.
Jeder Endpunkt, jedes Schema und jedes Beispiel bleibt synchron mit der Spezifikation, auf der die Plattform läuft. Erkunde sie und authentifiziere dich dann mit einem Personal Access Token.
API-Dokumentation
Die vollständige OpenAPI-Referenz: Endpunkte für Generierung, Assets, Jobs, Abrechnung und Konto, mit Schemas für Anfragen und Antworten.
Authentifizierung
Anfragen tragen ein Personal Access Token (PAT) als Bearer-Token. Erzeuge eines per POST an /pat mit einem Namen. Das Token im Klartext (mit dem Präfix nol_) wird nur einmal zurückgegeben, bewahre es also sicher auf.
curl -X POST https://api.nolgia.ai/pat -d '{"name":"my-cli"}'Sende es dann bei jeder Anfrage als Authorization: Bearer nol_…. Ein PAT verbraucht nur aufgeladene Credits, nie die monatlichen Credits des Tarifs, und Modelle, die Pro oder höher voraussetzen, brauchen weiterhin diesen Tarif.
CLI
Installiere die nolgia CLI.
Eine Rust-Binary für Bild, Video und Audio aus deinem Terminal. Jeder Weg unten installiert dasselbe Release.
Homebrew
brew tap nolgiainc/nolgia && brew install nolgiamacOS und Linux. Die Formula nolgia in nolgiainc/homebrew-nolgia folgt dem neuesten Release.
npm
npm install -g @nolgia/cliErfordert Node 18 oder neuer. Lädt beim postinstall die vorkompilierte Binary für deine Plattform herunter.
Shell-Installer
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bashDieser Befehl führt ein Skript aus dem main-Branch des Repositorys aus und lädt dann eine Release-Binary herunter. Wenn deine Umgebung Reviews oder Herkunftsprüfungen verlangt, speichere und prüfe zuerst install.sh und fixiere die Binary mit --tag.
Cargo
cargo install nolgia-cliBaut aus dem Quellcode mit einer stabilen Rust-Toolchain.
Release-Binaries
Vorkompilierte Binaries für jede Plattform im 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 und Plugins
Bring deinem Coding-Agenten NOLGIA bei.
Drei Skills, veröffentlicht unter nolgiainc/nolgia-skills, bringen Claude Code, Cursor und Codex die Plattform, Video-Prompting und UGC-Werbespots bei. Wähle den Installationsweg, den dein Agent nutzt.
Jeder Agent
npx skills add nolgiainc/nolgia-skillsErfordert Node.js. Die skills CLI erkennt Claude Code, Cursor, Codex und andere unterstützte Agenten.
GitHub CLI
gh skill install nolgiainc/nolgia-skills --allGitHub CLI 2.90 oder neuer (der Befehl ist in der Vorschau). Füge --scope user hinzu, um für jedes Projekt zu installieren.
Claude Code
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgiaGib diese Befehle in Claude Code ein. Registriert /nolgia:nolgia-platform, /nolgia:nolgia-video-prompting und /nolgia:nolgia-ugc-ads.
Cursor
Das Skills-Repo enthält ein Plugin-Manifest für Cursor. Der gehostete MCP-Server und ein Befehl /nolgia kommen aus nolgiainc/cursor-plugin.
nolgiainc/cursor-plugin auf GitHubCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope userCodex liest außerdem das Codex-Plugin-Manifest des Repos, wenn es als Plugin installiert ist.
Aus der nolgia CLI
nolgia skills installDie CLI enthält dieselben drei Skills. Ziele: --target claude-user, --target claude-project, --target hermes oder --target dir --dir <path>.
Füge das in deinen Agenten ein
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.Dein Coding-Agent installiert die CLI ohne sudo, wartet, während du dich authentifizierst, installiert die Skills und führt eine Testgenerierung aus.
Runbook lesenOffizielle SDKs
Vier Clients, eine Plattform.
Installiere den Client für deinen Stack und generiere in wenigen Minuten. Jedes SDK nutzt dieselbe API.
Python
PyPI · nolgiaTypisierter Client, generiert aus dem OpenAPI-Vertrag. Importiere AuthenticatedClient und rufe die Module nolgia.api.* auf.
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdkVollständig typisierter openapi-fetch-Client für Node und den Browser. Eine Installation bringt alles mit, was er braucht. Wird als ESM mit erstklassigen TypeScript-Definitionen ausgeliefert.
npm install @nolgia/sdkRust
crates.io · nolgiaAsynchroner Client auf tokio, generiert aus dem OpenAPI-Vertrag, mit eingebauten Retries, typisierten Fehlern, Warten auf Jobs, Uploads und Downloads. Eine Installation: Er re-exportiert seine Runtime und serde_json. Ein blockierender Client ist nur ein Feature-Flag entfernt.
cargo add nolgiaRust CLI
crates.io · nolgia-cliDer Befehl nolgia: eine einzige Rust-Binary, die Bild, Video und Audio aus deinem Terminal generiert. Für Rust-Code nutze das Crate nolgia oben.
cargo install nolgia-cliSchnellstart
Authentifizieren, dann aufrufen.
Erstelle einen Client mit deinem PAT, sende eine Bildgenerierung ab und frage den Job per Long Polling nach dem Asset ab: dieselben drei Aufrufe, mit denen jede SDK-README beginnt. Der Python-Client bietet typisierte nolgia.api.* Module, subscribe im Rust-Crate sendet ab und wartet in einem Aufruf, und die CLI steuert die Plattform aus deiner 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.pngMit NOLGIA entwickeln
Mehr als eine API.
Verbinde die Plattform über MCP mit deinem eigenen Assistenten, erweitere deinen Agenten mit Abilities aus dem Marketplace oder lass den NOLGIA Agent die Generierung für dich ausführen.
NOLGIA MCP
Füge NOLGIA zu Claude Code oder Cursor hinzu und generiere direkt in deinem eigenen Assistenten.
Assistenten verbindenMarketplace · Abilities
Installiere fertige Abilities, die deinem Agenten und deinen Workflows neue Fähigkeiten geben.
Marketplace durchsuchenAgent Sessions API
Steuere den NOLGIA Agent aus deinem eigenen Code: Sitzungen, Nachrichten, Streaming, Steuerung, Unterbrechen und Rückfragen, mit Run-Helpern in jedem SDK.
Anleitung zur Agent Sessions API lesenDer NOLGIA Agent
Ein gehosteter Agent, der dieselbe API steuert: Beschreibe den Shot, und er generiert.
Lerne den Agenten kennenToken holen, loslegen.
Erstelle ein Konto, erzeuge ein Personal Access Token und richte ein beliebiges SDK auf NOLGIA aus. Die ersten Credits gehen auf uns.

