Portail développeurs

Construisez sur NOLGIA.

Une API REST pour générer image, vidéo et audio, avec des guides, des SDK officiels en quatre langages, une CLI et des skills pour agents de code. URL de base https://api.nolgia.ai, authentifiée par un jeton d’accès personnel.

Un jeune homme tape sur un ordinateur portable à un pupitre d’écolier, sur un backlot de studio désert, pendant qu’une grue met en place derrière lui la façade grandeur nature d’un immeuble

Référence de l’API

En direct, générée à partir du contrat OpenAPI.

Chaque endpoint, schéma et exemple reste aligné sur la spécification qui fait tourner la plateforme. Explorez-la, puis authentifiez-vous avec un jeton d’accès personnel.

Documentation de l’API

La référence OpenAPI complète : endpoints de génération, médias, tâches, facturation et compte, avec les schémas de requête et de réponse.

docs.nolgia.ai
Lock

Authentification

Les requêtes portent un jeton d’accès personnel (PAT) comme jeton bearer. Créez-en un par une requête POST sur /pat avec un nom. Le jeton en clair (préfixé nol_) n’est renvoyé qu’une fois : conservez-le en sécurité.

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

Puis envoyez-le en Authorization: Bearer nol_… à chaque requête. Un PAT ne consomme que les crédits de recharge, jamais les crédits mensuels de l’offre, et les modèles qui exigent Pro ou plus nécessitent toujours cette offre.

Terminal window

CLI

Installez la CLI nolgia.

Un binaire Rust pour l’image, la vidéo et l’audio depuis votre terminal. Chaque méthode ci-dessous installe la même version.

Homebrew

shell
brew tap nolgiainc/nolgia && brew install nolgia

macOS et Linux. La formule nolgia de nolgiainc/homebrew-nolgia suit la dernière version.

npm

shell
npm install -g @nolgia/cli

Nécessite Node 18 ou plus récent. Télécharge le binaire précompilé pour votre plateforme pendant le postinstall.

Script d’installation shell

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

Cette commande exécute un script récupéré depuis la branche main du dépôt, puis télécharge un binaire de release. Si votre environnement exige une revue ou des contrôles de provenance, enregistrez et inspectez d’abord install.sh, et figez le binaire avec --tag.

Cargo

shell
cargo install nolgia-cli

Se compile depuis les sources avec une toolchain Rust stable.

Binaires de release

Binaires précompilés pour chaque plateforme dans la release 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
Dernière version sur GitHub
Référence complète de la CLI
Agent core with orbiting tasks

Skills et plugins

Apprenez NOLGIA à votre agent de code.

Trois skills, publiées sur nolgiainc/nolgia-skills, apprennent à Claude Code, Cursor et Codex la plateforme, le prompting vidéo et les pubs UGC. Choisissez la méthode d’installation de votre agent.

N’importe quel agent

shell
npx skills add nolgiainc/nolgia-skills

Nécessite Node.js. La CLI skills détecte Claude Code, Cursor, Codex et les autres agents pris en charge.

GitHub CLI

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

GitHub CLI 2.90 ou plus récent (la commande est en préversion). Ajoutez --scope user pour l’installer pour tous vos projets.

Claude Code

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

Tapez ces commandes dans Claude Code. Enregistre /nolgia:nolgia-platform, /nolgia:nolgia-video-prompting et /nolgia:nolgia-ugc-ads.

Cursor

Le dépôt des skills fournit un manifeste de plugin Cursor. Le serveur MCP hébergé et une commande /nolgia viennent de nolgiainc/cursor-plugin.

nolgiainc/cursor-plugin sur GitHub

Codex

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

Codex lit aussi le manifeste de plugin Codex du dépôt lorsqu’il est installé comme plugin.

Depuis la CLI nolgia

shell
nolgia skills install

La CLI embarque les trois mêmes skills. Cibles : --target claude-user, --target claude-project, --target hermes, ou --target dir --dir <path>.

Collez ceci dans votre agent

une ligne
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.

Votre agent de code installe la CLI sans sudo, attend pendant que vous vous authentifiez, installe les skills et lance une génération de vérification.

Lire le runbook
Guide d’installation et sources sur GitHub
Library of tiles

SDK officiels

Quatre clients, une plateforme.

Installez le client adapté à votre stack et commencez à générer en quelques minutes. Chaque SDK cible la même surface d’API.

Python

PyPI · nolgia

Client typé généré à partir du contrat OpenAPI. Importez AuthenticatedClient et appelez les modules nolgia.api.*.

shell
pip install nolgia

JavaScript / TypeScript

npm · @nolgia/sdk

Client openapi-fetch entièrement typé pour Node et le navigateur. Une seule installation apporte tout ce dont il a besoin. Livré en ESM avec des définitions TypeScript de premier ordre.

shell
npm install @nolgia/sdk

Rust

crates.io · nolgia

Client asynchrone sur tokio, généré à partir du contrat OpenAPI, avec relances, erreurs typées, attente des tâches, imports et téléchargements intégrés. Une seule installation : il réexporte son runtime et serde_json. Un client bloquant est à un feature flag près.

shell
cargo add nolgia

Rust CLI

crates.io · nolgia-cli

La commande nolgia : un seul binaire Rust qui génère image, vidéo et audio depuis votre terminal. Pour du code Rust, utilisez la crate nolgia ci-dessus.

shell
cargo install nolgia-cli

Démarrage rapide

Authentifiez-vous, puis appelez.

Créez un client avec votre PAT, soumettez une génération d’image et attendez la tâche en long polling pour récupérer le média : les trois mêmes appels qui ouvrent chaque README de SDK. Le client Python expose des modules typés nolgia.api.*, la crate Rust soumet et attend en un seul appel avec subscribe, et la CLI pilote la plateforme depuis votre shell.

Un jeune homme en veste de survêtement est assis tranquillement sur une plage avec son ordinateur portable, tandis qu’une vague haute comme un immeuble se dresse derrière lui, dorée par le soleil
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

Obtenez un jeton, commencez à construire.

Créez un compte, générez un jeton d’accès personnel et pointez n’importe quel SDK vers NOLGIA. Les premiers crédits sont pour nous.