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.

Ein junger Mann tippt an einer Schulbank auf einem leeren Studiogelände auf seinem Laptop, während hinter ihm ein Kran eine lebensgroße Gebäudefassade an ihren Platz senkt

API-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.

docs.nolgia.ai
Lock

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.

shell
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.

Terminal window

CLI

Installiere die nolgia CLI.

Eine Rust-Binary für Bild, Video und Audio aus deinem Terminal. Jeder Weg unten installiert dasselbe Release.

Homebrew

shell
brew tap nolgiainc/nolgia && brew install nolgia

macOS und Linux. Die Formula nolgia in nolgiainc/homebrew-nolgia folgt dem neuesten Release.

npm

shell
npm install -g @nolgia/cli

Erfordert Node 18 oder neuer. Lädt beim postinstall die vorkompilierte Binary für deine Plattform herunter.

Shell-Installer

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

Dieser 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

shell
cargo install nolgia-cli

Baut 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_64
  • nolgia-aarch64-unknown-linux-gnuLinux arm64
  • nolgia-x86_64-pc-windows-msvc.exeWindows x86_64
  • nolgia-aarch64-pc-windows-msvc.exeWindows arm64
Neuestes Release auf GitHub
Vollständige CLI-Referenz
Agent core with orbiting tasks

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

shell
npx skills add nolgiainc/nolgia-skills

Erfordert Node.js. Die skills CLI erkennt Claude Code, Cursor, Codex und andere unterstützte Agenten.

GitHub CLI

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

GitHub 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

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

Gib 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 GitHub

Codex

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

Codex liest außerdem das Codex-Plugin-Manifest des Repos, wenn es als Plugin installiert ist.

Aus der nolgia CLI

shell
nolgia skills install

Die 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

eine Zeile
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 lesen
Installationsanleitung und Quellcode auf GitHub
Library of tiles

Offizielle SDKs

Vier Clients, eine Plattform.

Installiere den Client für deinen Stack und generiere in wenigen Minuten. Jedes SDK nutzt dieselbe API.

Python

PyPI · nolgia

Typisierter Client, generiert aus dem OpenAPI-Vertrag. Importiere AuthenticatedClient und rufe die Module nolgia.api.* auf.

shell
pip install nolgia

JavaScript / TypeScript

npm · @nolgia/sdk

Vollstä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.

shell
npm install @nolgia/sdk

Rust

crates.io · nolgia

Asynchroner 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.

shell
cargo add nolgia

Rust CLI

crates.io · nolgia-cli

Der Befehl nolgia: eine einzige Rust-Binary, die Bild, Video und Audio aus deinem Terminal generiert. Für Rust-Code nutze das Crate nolgia oben.

shell
cargo install nolgia-cli

Schnellstart

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.

Ein junger Mann in Trainingsjacke sitzt ruhig mit seinem Laptop an einem Strand, während sich hinter ihm eine Welle so hoch wie ein Gebäude auftürmt, golden von der Sonne angestrahlt
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

Token holen, loslegen.

Erstelle ein Konto, erzeuge ein Personal Access Token und richte ein beliebiges SDK auf NOLGIA aus. Die ersten Credits gehen auf uns.