NOLGIA

Portal do desenvolvedor

Construa com o NOLGIA.

Uma API REST para gerar imagem, vídeo e áudio, com guias, SDKs oficiais em quatro linguagens, uma CLI e skills para agentes de programação. URL base https://api.nolgia.ai, autenticada com um token de acesso pessoal.

Um jovem digita num notebook numa carteira escolar numa cidade cenográfica vazia, enquanto um guindaste desce atrás dele a fachada de um prédio em tamanho real

Referência da API

Sempre atualizada, gerada a partir do contrato OpenAPI.

Cada endpoint, esquema e exemplo acompanha de perto a especificação que move a plataforma. Explore e depois autentique com um token de acesso pessoal.

Documentação da API

A referência OpenAPI completa: endpoints de geração, arquivos, trabalhos, cobrança e conta, com esquemas de requisição e resposta.

docs.nolgia.ai
Lock

Autenticação

As requisições levam um token de acesso pessoal (PAT) como token bearer. Crie um com um POST para /pat informando um nome. O token em texto puro (com o prefixo nol_) é retornado uma única vez, então guarde-o com segurança.

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

Depois envie-o como Authorization: Bearer nol_… em toda requisição. Um PAT gasta só créditos de recarga, nunca os créditos mensais do plano, e os modelos que exigem Pro ou superior continuam exigindo esse plano.

Terminal window

CLI

Instale a CLI nolgia.

Um binário em Rust para imagem, vídeo e áudio no seu terminal. Todos os caminhos abaixo instalam a mesma versão.

Homebrew

shell
brew tap nolgiainc/nolgia && brew install nolgia

macOS e Linux. A fórmula nolgia em nolgiainc/homebrew-nolgia acompanha a versão mais recente.

npm

shell
npm install -g @nolgia/cli

Requer Node 18 ou mais recente. Baixa o binário pré-compilado para a sua plataforma durante o postinstall.

Instalador via shell

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

Este comando executa um script baixado da branch main do repositório e depois baixa um binário da versão publicada. Se o seu ambiente exige revisão ou verificação de procedência, salve e inspecione o install.sh antes e fixe o binário com --tag.

Cargo

shell
cargo install nolgia-cli

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

Binários da versão

Binários pré-compilados para todas as plataformas na versão do 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
Versão mais recente no GitHub
Referência completa da CLI
Agent core with orbiting tasks

Skills e plugins

Ensine o NOLGIA ao seu agente de programação.

Três skills, publicadas em nolgiainc/nolgia-skills, ensinam ao Claude Code, ao Cursor e ao Codex a plataforma, prompts de vídeo e anúncios UGC. Escolha o caminho de instalação que seu agente usa.

Qualquer agente

shell
npx skills add nolgiainc/nolgia-skills

Requer Node.js. A CLI de skills detecta o Claude Code, o Cursor, o Codex e outros agentes compatíveis.

GitHub CLI

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

GitHub CLI 2.90 ou mais recente (o comando está em prévia). Adicione --scope user para instalar em todos os projetos.

Claude Code

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

Digite estes comandos dentro do Claude Code. Registra /nolgia:nolgia-platform, /nolgia:nolgia-video-prompting e /nolgia:nolgia-ugc-ads.

Cursor

O repositório de skills inclui um manifesto de plugin do Cursor. O servidor MCP hospedado e um comando /nolgia vêm de nolgiainc/cursor-plugin.

nolgiainc/cursor-plugin no GitHub

Codex

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

O Codex também lê o manifesto de plugin do Codex do repositório quando instalado como plugin.

Pela CLI nolgia

shell
nolgia skills install

A CLI inclui as mesmas três skills. Destinos: --target claude-user, --target claude-project, --target hermes ou --target dir --dir <path>.

Cole isto no seu agente

uma linha
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
Guia de instalação e código-fonte no GitHub
Library of tiles

SDKs oficiais

Quatro clientes, uma plataforma.

Instale o cliente da sua stack e comece a gerar em minutos. Todos os SDKs usam a mesma API.

Python

PyPI · nolgia

Cliente tipado gerado a partir do contrato OpenAPI. Importe AuthenticatedClient e chame os módulos nolgia.api.*.

shell
pip install nolgia

JavaScript / TypeScript

npm · @nolgia/sdk

Cliente openapi-fetch totalmente tipado para Node e navegador. Uma instalação traz tudo de que ele precisa. Vem em ESM com definições TypeScript de primeira linha.

shell
npm install @nolgia/sdk

Rust

crates.io · nolgia

Cliente assíncrono em tokio, gerado a partir do contrato OpenAPI, com novas tentativas, erros tipados, espera de trabalhos, uploads e downloads integrados. Uma instalação só: ele reexporta seu runtime e o serde_json. Um cliente bloqueante está a uma feature flag de distância.

shell
cargo add nolgia

Rust CLI

crates.io · nolgia-cli

O comando nolgia: um único binário em Rust que gera imagem, vídeo e áudio pelo terminal. Para código Rust, use o crate nolgia acima.

shell
cargo install nolgia-cli

Início rápido

Autentique e depois chame.

Crie um cliente com seu PAT, envie uma geração de imagem e faça long-polling do trabalho até receber o arquivo: as mesmas três chamadas com que cada README de SDK começa. O cliente Python expõe módulos tipados nolgia.api.*, o subscribe do crate Rust envia e espera numa só chamada, e a CLI comanda a plataforma pelo seu shell.

Um jovem de jaqueta esportiva está sentado tranquilo numa praia com o notebook enquanto uma onda da altura de um prédio se ergue atrás dele, dourada pelo sol
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

Pegue um token e comece a construir.

Crie uma conta, gere um token de acesso pessoal e aponte qualquer SDK para o NOLGIA. Os primeiros créditos são por nossa conta.