CLI et serveur MCP

Générez depuis votre terminal, ou depuis votre agent.

La CLI nolgia est un seul binaire Rust pour générer image, vidéo et audio. Le serveur MCP NOLGIA expose la même plateforme à Claude Code et à tout autre agent. Un compte, deux portes d’entrée.

shell
npm install -g @nolgia/cli
Une jeune femme en manteau de fourrure blanc tape sur un clavier posé sur ses genoux, assise sur une pile de vieux téléviseurs dans un parking de nuit, chaque écran montrant le palmier qui brûle derrière elle

Installation

Choisissez votre gestionnaire de paquets.

Un binaire, quatre façons de l’obtenir. Tous les canaux suivent la même version.

shell
npm install -g @nolgia/cli

Installe le binaire précompilé pour votre plateforme. Nécessite Node 18+.

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

Démarrage rapide

Authentifiez-vous, puis générez.

Connectez-vous une fois avec nolgia auth login, puis générez avec n’importe quel modèle pris en charge. Composez des séquences multiplans avec plusieurs options --shot, et passez --cost-only pour chiffrer une tâche avant de la lancer.

terminal
# Authenticate once: opens a device login in your browser
nolgia auth login

# Generate an 8-second clip from a prompt
nolgia gen video \
  --model veo-3.1 \
  --prompt "a street bike carving a coastal road at dusk" \
  --duration-seconds 8 \
  --out clip.mp4
multi-shot
# Direct a multi-shot sequence: one --shot per beat.
# Add --cost-only first to see the credit estimate before spending.
nolgia gen video \
  --model veo-3.1 \
  --shot "8:WIDE SHOT: city skyline at golden hour, slow push in" \
  --shot "6:MEDIUM SHOT: rider mounts the bike, engine catches" \
  --shot "8:CLOSE UP: throttle twists, headlight flares" \
  --out sequence.mp4 \
  --cost-only
Chiffrez d’abord
nolgia gen video --model veo-3.1 --prompt "…" --cost-only

POST /jobs/cost dans l’API renvoie le même chiffre.

Conçu pour celles et ceux qui vivent dans le terminal.

Aucun tableau de bord à surveiller. Tout ce que fait le Studio n’est qu’à une commande ou un appel d’outil.

Un client pour les humains et les agents

Un client pour les humains et les agents

La même plateforme derrière le terminal et le serveur MCP. Scriptez-la à la main, ou laissez Claude Code la piloter. Les capacités sont identiques.

Tarification en crédits transparente

Tarification en crédits transparente

Ajoutez --cost-only à n’importe quelle génération pour obtenir une estimation en crédits avant de dépenser. Pas de facturation surprise, pas de multiplicateurs cachés.

Modèle de tâches asynchrone

Modèle de tâches asynchrone

Chaque génération est une tâche que vous pouvez attendre ou interroger. Lancez un lot, partez, et récupérez les résultats quand ils arrivent.

Séquences multiplans natives

Séquences multiplans natives

Composez des séquences cinématographiques avec plusieurs options --shot. Dirigez plans larges, plans moyens et gros plans en une seule commande.

L’image vers vidéo partout

L’image vers vidéo partout

Générez de la vidéo à partir d’une image fixe sur chaque modèle compatible, avec un jeu d’options cohérent.

Fonctionne dans Claude Code

Fonctionne dans Claude Code

Pointez n’importe quel client MCP vers le serveur hébergé avec un jeton bearer, et tous les outils apparaissent dans votre agent.

Serveur MCP

Donnez toute la plateforme à votre agent.

Le serveur MCP NOLGIA est hébergé sur https://mcp.nolgia.ai/mcp et utilise le transport MCP Streamable HTTP. Authentifiez-vous avec un PAT ou un JWT bearer et les 81 outils deviennent disponibles dans Claude Code, Cursor ou tout client MCP capable d’envoyer un en-tête. Les assistants qui vous connectent au lieu de prendre un jeton sont traités sur la page MCP.

mcp.json
{
  "mcpServers": {
    "nolgia": {
      "url": "https://mcp.nolgia.ai/mcp",
      "headers": {
        "Authorization": "Bearer nol_your_token_here"
      }
    }
  }
}

Générez un jeton d’accès personnel depuis votre compte, puis placez-le dans l’en-tête Authorization. Redémarrez votre client pour qu’il prenne en compte le serveur.

81 outils, lus depuis le registre du serveur lui-même

Generate

Generate: 17 outils
OutilFonction
nolgia_text_to_imageGenerate image from text
nolgia_image_to_imageGenerate image from an image
nolgia_text_to_videoGenerate video from text
nolgia_image_to_videoAnimate an image into video
nolgia_text_to_audioGenerate audio from text
nolgia_run_presetRun a preset
nolgia_render_blocksAssemble clips and narration into one video
nolgia_multicam_planPlan a Multicam job
nolgia_multicam_startStart a Multicam job
nolgia_multicam_runCheck a Multicam job
nolgia_multicam_downloadDownload every Multicam angle
nolgia_multicam_cancelStop a Multicam job
nolgia_generate_3dGenerate a 3D model
nolgia_generate_setGenerate a set of images
nolgia_miroge_optionsPrice a Miroge remake
nolgia_mirogeRemake a clip with Miroge
nolgia_analyze_referenceAnalyze a reference video

Your library

Your library: 25 outils
OutilFonction
nolgia_list_assetsList generated assets
nolgia_get_assetOpen an asset
nolgia_delete_assetTrash an asset
nolgia_update_asset_tagsSet an asset's tags
nolgia_upload_assetUpload an image
nolgia_list_charactersList saved characters
nolgia_get_characterGet one character
nolgia_create_characterSave a character
nolgia_update_characterUpdate a character
nolgia_delete_characterDelete a character
nolgia_list_stylesList saved styles
nolgia_create_styleSave a style
nolgia_delete_styleDelete a saved style
nolgia_transcribe_assetTranscribe an asset
nolgia_get_transcriptGet an asset transcript
nolgia_suggest_clipsFind short video clips
nolgia_create_clipsCreate short video clips
nolgia_get_setGet a set of images
nolgia_get_mirogeCheck a Miroge remake
nolgia_get_reference_analysisRead a reference analysis
nolgia_apply_lookApply a look to generations
nolgia_look_from_analysisMake a look from a reference analysis
nolgia_merge_look_analysesTeach a look from several videos
nolgia_match_lookRe-cut a timeline to a look
nolgia_score_edit_dnaScore a render against a look

Projects

Projects: 11 outils
OutilFonction
nolgia_list_projectsList projects
nolgia_get_projectGet one project
nolgia_create_projectCreate a project
nolgia_update_projectUpdate a project
nolgia_delete_projectDelete a project
nolgia_add_project_assetsAdd assets to a project
nolgia_remove_project_assetRemove an asset from a project
nolgia_list_canvasesList canvases
nolgia_get_canvasGet a canvas
nolgia_create_canvasCreate a canvas
nolgia_update_canvasUpdate a canvas

Edit sessions and tweaks

Edit sessions and tweaks: 6 outils
OutilFonction
nolgia_list_tweak_scopesList image tweak scopes
nolgia_create_edit_sessionStart an edit session
nolgia_get_edit_sessionRead an edit session
nolgia_edit_session_stepApply the next image edit
nolgia_revert_edit_sessionRevert an edit session
nolgia_estimate_edit_sessionEstimate the next edit

Presets

Presets: 2 outils
OutilFonction
nolgia_list_presetsList presets
nolgia_get_presetGet one preset

Timelines

Timelines: 4 outils
OutilFonction
nolgia_validate_maskValidate a timeline mask
nolgia_validate_motionValidate timeline motion
nolgia_list_color_presetsList color-grade presets
nolgia_get_renderCheck a render

Desktop apps

Desktop apps: 11 outils
OutilFonction
nolgia_app_statusList connected desktop apps
nolgia_app_infoRead a desktop app's state
nolgia_app_runRun code in a desktop app
nolgia_app_commandCheck a desktop app command
nolgia_app_previewPreview a desktop app's document
nolgia_app_importImport an asset into a desktop app
nolgia_app_exportExport from a desktop app
nolgia_app_saveSave the document in a desktop app
nolgia_app_openOpen a document in a desktop app
nolgia_app_ditDo the DIT on the person's computer
nolgia_app_transcribeTranscribe clips in Premiere Pro

Models, account and jobs

Models, account and jobs: 5 outils
OutilFonction
nolgia_list_modelsList models
nolgia_get_accountGet the signed-in account
nolgia_get_usageGet generation counts
nolgia_cancel_jobCancel a generation job
nolgia_list_jobsList generation jobs

Modèles

Les modèles vers lesquels la CLI route.

image

GPT Image 2.5 Sunburst

à partir de 8 crédits par image

Voir le modèle

audio

ElevenLabs v3 Conversational

à partir de 3 crédits pour 1 000 caractères

Voir le modèle
Explorer tous les modèles

FAQ

Questions depuis le terminal.

Comment installer la CLI nolgia ?
Avec npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli) et curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). Tous les canaux suivent la même version.
Comment me connecter depuis le terminal ?
Lancez nolgia auth login une fois. La commande ouvre une connexion d’appareil dans votre navigateur et la CLI conserve la session.
Puis-je voir le coût d’une tâche avant de la lancer ?
Oui. Ajoutez --cost-only à n’importe quelle génération pour obtenir l’estimation en crédits sans rien dépenser.
Que peut générer la CLI ?
Images, vidéo et audio sur les modèles publiés par la plateforme, y compris des séquences vidéo multiplans avec plusieurs options --shot et de la vidéo à partir d’une image fixe.
Comment connecter Claude Code ou un autre agent ?
Pointez votre client MCP vers https://mcp.nolgia.ai/mcp avec un en-tête Authorization: Bearer contenant un jeton d’accès personnel, et les 81 outils apparaissent dans votre agent.
La CLI et l’app partagent-elles les crédits ?
Si vous vous connectez avec nolgia auth login, oui : la CLI consomme d’abord les crédits mensuels de votre offre, puis vos crédits de recharge, comme l’app. Un jeton d’accès personnel (NOLGIA_TOKEN), également utilisé par l’API et le serveur MCP, ne consomme que les crédits de recharge. Un assistant connecté via OAuth, comme ChatGPT ou Claude, consomme comme l’app.
Mon agent de code peut-il installer la CLI pour moi ?
Oui. Copiez l’instruction d’une ligne sous Collez ceci dans votre agent. Elle dirige votre agent de code vers le runbook d’installation à l’adresse https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md, qui couvre l’installation, l’authentification, les skills et une génération de vérification.
Comment savoir ce que coûtera une tâche ?
Utilisez --cost-only dans la CLI ou POST /jobs/cost dans l’API. Les deux utilisent le même moteur de tarification et renvoient la même estimation en crédits avant que vous génériez.

Connectez un agent.

Créez un compte, générez un jeton et pointez votre CLI ou votre client MCP vers NOLGIA. Les premiers crédits sont pour nous.