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.

Guides
Commencez par un guide.
Découvrez la plateforme avec les guides sur docs.nolgia.ai, ou générez depuis Claude ou Cursor avec MCP.
Démarrage rapide
Installez un client et lancez votre première génération.
Lire le guideAuthentification
Créez un jeton et authentifiez les requêtes API.
Lire le guideTâches
Soumettez une génération et attendez son résultat.
Lire le guideImports
Importez des fichiers de référence pour vos générations.
Lire le guideErreurs
Comprenez les erreurs de l’API et comment les gérer.
Lire le guideFacturation
Suivez les crédits et les coûts de génération.
Lire le guideOrganisations
Gérez les accès de l’équipe et les ressources partagées.
Lire le guideAgent Sessions API
Créez des sessions et envoyez des messages à NOLGIA Agent.
Lire le guideBibliothèques clientes
Choisissez un client officiel pour votre langage.
Lire le guideRéférence de l’API
Explorez chaque endpoint de l’API et chaque schéma de requête.
Ouvrir la référencellms.txt
Lisez l’index en texte brut de la documentation, pensé pour les agents de code.
Ouvrir llms.txtRé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.
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é.
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.
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
brew tap nolgiainc/nolgia && brew install nolgiamacOS et Linux. La formule nolgia de nolgiainc/homebrew-nolgia suit la dernière version.
npm
npm install -g @nolgia/cliNécessite Node 18 ou plus récent. Télécharge le binaire précompilé pour votre plateforme pendant le postinstall.
Script d’installation shell
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bashCette 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
cargo install nolgia-cliSe 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_64nolgia-aarch64-unknown-linux-gnuLinux arm64nolgia-x86_64-pc-windows-msvc.exeWindows x86_64nolgia-aarch64-pc-windows-msvc.exeWindows arm64
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
npx skills add nolgiainc/nolgia-skillsNécessite Node.js. La CLI skills détecte Claude Code, Cursor, Codex et les autres agents pris en charge.
GitHub CLI
gh skill install nolgiainc/nolgia-skills --allGitHub 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
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgiaTapez 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 GitHubCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope userCodex lit aussi le manifeste de plugin Codex du dépôt lorsqu’il est installé comme plugin.
Depuis la CLI nolgia
nolgia skills installLa 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
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 runbookSDK 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 · nolgiaClient typé généré à partir du contrat OpenAPI. Importez AuthenticatedClient et appelez les modules nolgia.api.*.
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdkClient 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.
npm install @nolgia/sdkRust
crates.io · nolgiaClient 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.
cargo add nolgiaRust CLI
crates.io · nolgia-cliLa 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.
cargo install nolgia-cliDé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.

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.pngConstruire sur NOLGIA
Plus qu’une API.
Connectez la plateforme à votre propre assistant via MCP, enrichissez votre agent avec des abilities de la Marketplace, ou laissez NOLGIA Agent lancer la génération pour vous.
NOLGIA MCP
Ajoutez NOLGIA à Claude Code ou Cursor et générez depuis votre propre assistant.
Connecter votre assistantMarketplace · Abilities
Installez des abilities prêtes à l’emploi qui ajoutent de nouvelles compétences à votre agent et à vos workflows.
Parcourir la MarketplaceAgent Sessions API
Pilotez NOLGIA Agent depuis votre propre code : sessions, messages, streaming, orientation, interruption et questions, avec des helpers d’exécution dans chaque SDK.
Lire le guide de l’API Agent SessionsNOLGIA Agent
Un agent hébergé qui pilote la même API : décrivez le plan, il le génère.
Découvrir l’AgentObtenez 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.

