Como instalo a CLI nolgia?

Com npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli) e curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). Todos os canais acompanham a mesma versão.

Como faço login pelo terminal?

Execute nolgia auth login uma vez. Ele abre um login de dispositivo no seu navegador e a CLI mantém a sessão.

O que a CLI pode gerar?

Imagens, vídeo e áudio nos modelos que a plataforma publica, incluindo sequências de vídeo com vários planos a partir de flags --shot repetidas e vídeo a partir de uma imagem estática.

Como conecto o Claude Code ou outro agente?

Aponte seu cliente MCP para https://mcp.nolgia.ai/mcp com um cabeçalho Authorization: Bearer contendo um token de acesso pessoal, e todas as 81 ferramentas aparecem no seu agente.

A CLI e o app compartilham créditos?

Quando você faz login com nolgia auth login, sim: a CLI gasta primeiro os créditos mensais do seu plano e depois os créditos de recarga, como o app. Um token de acesso pessoal (NOLGIA_TOKEN), que a API e o servidor MCP também usam, gasta só créditos de recarga. Um assistente que você conecta por OAuth, como o ChatGPT ou o Claude, gasta como o app.

Meu agente de programação pode configurar a CLI para mim?

Sim. Copie a instrução de uma linha em Cole isto no seu agente. Ela leva seu agente de programação ao runbook de instalação em https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md, que passa pela instalação, autenticação, skills e uma geração de verificação.

Como vejo quanto um trabalho vai custar?

Use --cost-only na CLI ou POST /jobs/cost na API. Os dois usam o mesmo cálculo de preço e retornam a mesma estimativa de créditos antes de você gerar.

CLI e servidor MCP

Gere pelo terminal ou pelo seu agente.

A CLI nolgia é um único binário em Rust para gerar imagem, vídeo e áudio. O servidor MCP do NOLGIA abre a mesma plataforma para o Claude Code e qualquer outro agente. Uma conta, duas formas de entrar.

$ npm install -g @nolgia/cli

Obter um token de acesso Conectar um agente

Uma jovem com casaco de pele branco digita num teclado no colo, sentada numa pilha de televisões antigas num estacionamento à noite, com cada tela mostrando a palmeira que queima atrás dela

Instalar

Escolha seu gerenciador de pacotes.

Um binário, quatro formas de obter. Todos os canais acompanham a mesma versão.

$ npm install -g @nolgia/cli

Instala o binário pré-compilado para a sua plataforma. Requer Node 18+.

$ brew install nolgiainc/nolgia/nolgia

macOS e Linux. Acompanha a versão marcada mais recente.

$ cargo install nolgia-cli

Compila a partir do código-fonte com uma toolchain estável do Rust.

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

Detecta seu sistema operacional e sua arquitetura e coloca o binário no seu PATH.

Cole isto no seu agente

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.

Seu agente de programação instala a CLI sem sudo, espera enquanto você se autentica, instala as skills e faz uma geração de verificação.

Ler o runbook

Início rápido

Autentique e depois gere.

Faça login uma vez com nolgia auth login e depois gere com qualquer modelo compatível. Monte sequências com vários planos usando flags --shot repetidas e passe --cost-only para ver o preço de um trabalho antes de executá-lo.

# 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

# 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

$ nolgia gen video --model veo-3.1 --prompt "…" --cost-only

O POST /jobs/cost da API retorna o mesmo número.

Feito para quem vive no terminal.

Sem painéis para vigiar. Tudo o que o Studio faz está a um comando ou a uma chamada de ferramenta de distância.

Um cliente para pessoas e agentes

A mesma plataforma por trás do terminal e do servidor MCP. Escreva scripts à mão ou deixe o Claude Code no comando. Os recursos são idênticos.

Preço transparente em créditos

Adicione --cost-only a qualquer geração para ver a estimativa de créditos antes de gastar. Sem cobranças surpresa, sem multiplicadores escondidos.

Modelo de trabalhos assíncronos

Cada geração é um trabalho que você pode aguardar ou consultar. Dispare um lote, vá fazer outra coisa e colete os resultados quando chegarem.

Sequências nativas com vários planos

Monte sequências cinematográficas com flags --shot repetidas. Dirija planos abertos, médios e closes num único comando.

Imagem para vídeo em todo lugar

Gere vídeo a partir de uma imagem estática em todo modelo compatível, com um só conjunto de flags.

Funciona no Claude Code

Aponte qualquer cliente MCP para o servidor hospedado com um token bearer, e todas as ferramentas aparecem no seu agente.

Servidor MCP

Dê ao seu agente a plataforma inteira.

O servidor MCP do NOLGIA fica hospedado em https://mcp.nolgia.ai/mcp e usa o transporte MCP Streamable HTTP. Autentique com um PAT ou JWT bearer, e todas as 81 ferramentas ficam disponíveis para o Claude Code, o Cursor ou qualquer cliente MCP que consiga enviar um cabeçalho. Assistentes que fazem login em vez de receber um token são explicados na página do MCP.

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

Gere um token de acesso pessoal na sua conta e coloque-o no cabeçalho Authorization. Reinicie seu cliente para ele reconhecer o servidor.

81 ferramentas, lidas do próprio registro do servidor

Generate

Generate: 17 ferramentas
Ferramenta	Função
`nolgia_text_to_image`	Generate image from text
`nolgia_image_to_image`	Generate image from an image
`nolgia_text_to_video`	Generate video from text
`nolgia_image_to_video`	Animate an image into video
`nolgia_text_to_audio`	Generate audio from text
`nolgia_run_preset`	Run a preset
`nolgia_render_blocks`	Assemble clips and narration into one video
`nolgia_multicam_plan`	Plan a Multicam job
`nolgia_multicam_start`	Start a Multicam job
`nolgia_multicam_run`	Check a Multicam job
`nolgia_multicam_download`	Download every Multicam angle
`nolgia_multicam_cancel`	Stop a Multicam job
`nolgia_generate_3d`	Generate a 3D model
`nolgia_generate_set`	Generate a set of images
`nolgia_miroge_options`	Price a Miroge remake
`nolgia_miroge`	Remake a clip with Miroge
`nolgia_analyze_reference`	Analyze a reference video

Your library

Your library: 25 ferramentas
Ferramenta	Função
`nolgia_list_assets`	List generated assets
`nolgia_get_asset`	Open an asset
`nolgia_delete_asset`	Trash an asset
`nolgia_update_asset_tags`	Set an asset's tags
`nolgia_upload_asset`	Upload an image
`nolgia_list_characters`	List saved characters
`nolgia_get_character`	Get one character
`nolgia_create_character`	Save a character
`nolgia_update_character`	Update a character
`nolgia_delete_character`	Delete a character
`nolgia_list_styles`	List saved styles
`nolgia_create_style`	Save a style
`nolgia_delete_style`	Delete a saved style
`nolgia_transcribe_asset`	Transcribe an asset
`nolgia_get_transcript`	Get an asset transcript
`nolgia_suggest_clips`	Find short video clips
`nolgia_create_clips`	Create short video clips
`nolgia_get_set`	Get a set of images
`nolgia_get_miroge`	Check a Miroge remake
`nolgia_get_reference_analysis`	Read a reference analysis
`nolgia_apply_look`	Apply a look to generations
`nolgia_look_from_analysis`	Make a look from a reference analysis
`nolgia_merge_look_analyses`	Teach a look from several videos
`nolgia_match_look`	Re-cut a timeline to a look
`nolgia_score_edit_dna`	Score a render against a look

Projects

Projects: 11 ferramentas
Ferramenta	Função
`nolgia_list_projects`	List projects
`nolgia_get_project`	Get one project
`nolgia_create_project`	Create a project
`nolgia_update_project`	Update a project
`nolgia_delete_project`	Delete a project
`nolgia_add_project_assets`	Add assets to a project
`nolgia_remove_project_asset`	Remove an asset from a project
`nolgia_list_canvases`	List canvases
`nolgia_get_canvas`	Get a canvas
`nolgia_create_canvas`	Create a canvas
`nolgia_update_canvas`	Update a canvas

Edit sessions and tweaks

Edit sessions and tweaks: 6 ferramentas
Ferramenta	Função
`nolgia_list_tweak_scopes`	List image tweak scopes
`nolgia_create_edit_session`	Start an edit session
`nolgia_get_edit_session`	Read an edit session
`nolgia_edit_session_step`	Apply the next image edit
`nolgia_revert_edit_session`	Revert an edit session
`nolgia_estimate_edit_session`	Estimate the next edit

Presets

Presets: 2 ferramentas
Ferramenta	Função
`nolgia_list_presets`	List presets
`nolgia_get_preset`	Get one preset

Timelines

Timelines: 4 ferramentas
Ferramenta	Função
`nolgia_validate_mask`	Validate a timeline mask
`nolgia_validate_motion`	Validate timeline motion
`nolgia_list_color_presets`	List color-grade presets
`nolgia_get_render`	Check a render

Desktop apps

Desktop apps: 11 ferramentas
Ferramenta	Função
`nolgia_app_status`	List connected desktop apps
`nolgia_app_info`	Read a desktop app's state
`nolgia_app_run`	Run code in a desktop app
`nolgia_app_command`	Check a desktop app command
`nolgia_app_preview`	Preview a desktop app's document
`nolgia_app_import`	Import an asset into a desktop app
`nolgia_app_export`	Export from a desktop app
`nolgia_app_save`	Save the document in a desktop app
`nolgia_app_open`	Open a document in a desktop app
`nolgia_app_dit`	Do the DIT on the person's computer
`nolgia_app_transcribe`	Transcribe clips in Premiere Pro

Models, account and jobs

Models, account and jobs: 5 ferramentas
Ferramenta	Função
`nolgia_list_models`	List models
`nolgia_get_account`	Get the signed-in account
`nolgia_get_usage`	Get generation counts
`nolgia_cancel_job`	Cancel a generation job
`nolgia_list_jobs`	List generation jobs

Modelos

Os modelos que a CLI usa.

vídeo

Wan 3.0

a partir de 14 créditos por clipe de 5s

Ver o modelo

vídeo

Hailuo 3

a partir de 37 créditos por clipe de 5s

Ver o modelo

vídeo

Seedance 2.5

a partir de 26 créditos por clipe de 5s

Ver o modelo

imagem

GPT Image 2.5 Sunburst

a partir de 8 créditos por imagem

Ver o modelo

imagem

Nano Banana 2.1

a partir de 4 créditos por imagem

Ver o modelo

imagem

Grok Imagine 2.0

a partir de 4 créditos por imagem

Ver o modelo

áudio

ElevenLabs v3 Conversational

a partir de 3 créditos por 1.000 caracteres

Ver o modelo

áudio

Lyria 3.5

a partir de 5 créditos por geração

Ver o modelo

Explorar todos os modelos

FAQ

Perguntas do terminal.

Como instalo a CLI nolgia?: Com npm (npm install -g @nolgia/cli), Homebrew (brew install nolgiainc/nolgia/nolgia), cargo (cargo install nolgia-cli) e curl (curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash). Todos os canais acompanham a mesma versão.
Como faço login pelo terminal?: Execute nolgia auth login uma vez. Ele abre um login de dispositivo no seu navegador e a CLI mantém a sessão.
Posso ver quanto um trabalho custa antes de executá-lo?: Sim. Adicione --cost-only a qualquer geração para ver a estimativa de créditos sem gastar nada.
O que a CLI pode gerar?: Imagens, vídeo e áudio nos modelos que a plataforma publica, incluindo sequências de vídeo com vários planos a partir de flags --shot repetidas e vídeo a partir de uma imagem estática.
Como conecto o Claude Code ou outro agente?: Aponte seu cliente MCP para https://mcp.nolgia.ai/mcp com um cabeçalho Authorization: Bearer contendo um token de acesso pessoal, e todas as 81 ferramentas aparecem no seu agente.
A CLI e o app compartilham créditos?: Quando você faz login com nolgia auth login, sim: a CLI gasta primeiro os créditos mensais do seu plano e depois os créditos de recarga, como o app. Um token de acesso pessoal (NOLGIA_TOKEN), que a API e o servidor MCP também usam, gasta só créditos de recarga. Um assistente que você conecta por OAuth, como o ChatGPT ou o Claude, gasta como o app.
Meu agente de programação pode configurar a CLI para mim?: Sim. Copie a instrução de uma linha em Cole isto no seu agente. Ela leva seu agente de programação ao runbook de instalação em https://github.com/nolgiainc/nolgia-cli/blob/main/INSTALL_FOR_AGENTS.md, que passa pela instalação, autenticação, skills e uma geração de verificação.
Como vejo quanto um trabalho vai custar?: Use --cost-only na CLI ou POST /jobs/cost na API. Os dois usam o mesmo cálculo de preço e retornam a mesma estimativa de créditos antes de você gerar.

Conecte um agente.

Crie uma conta, gere um token e aponte sua CLI ou seu cliente MCP para o NOLGIA. Os primeiros créditos são por nossa conta.

Comece · grátis Ver preços