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.

Guias
Comece com um guia.
Conheça a plataforma com os guias em docs.nolgia.ai, ou gere pelo Claude ou pelo Cursor com MCP.
Início rápido
Instale um cliente e faça sua primeira geração.
Ler o guiaAutenticação
Crie um token e autentique as requisições da API.
Ler o guiaTrabalhos
Envie uma geração e aguarde o resultado.
Ler o guiaUploads
Envie arquivos de referência para suas gerações.
Ler o guiaErros
Entenda os erros da API e como tratá-los.
Ler o guiaCobrança
Acompanhe créditos e custos de geração.
Ler o guiaOrganizações
Gerencie o acesso da equipe e os recursos compartilhados.
Ler o guiaAgent Sessions API
Crie sessões e envie mensagens ao NOLGIA Agent.
Ler o guiaBibliotecas de cliente
Escolha um cliente oficial para a sua linguagem.
Ler o guiaReferência da API
Explore cada endpoint e esquema de requisição da API.
Abrir a referênciallms.txt
Leia o índice da documentação em texto simples para agentes de programação.
Abrir llms.txtReferê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.
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.
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.
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
brew tap nolgiainc/nolgia && brew install nolgiamacOS e Linux. A fórmula nolgia em nolgiainc/homebrew-nolgia acompanha a versão mais recente.
npm
npm install -g @nolgia/cliRequer Node 18 ou mais recente. Baixa o binário pré-compilado para a sua plataforma durante o postinstall.
Instalador via shell
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bashEste 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
cargo install nolgia-cliCompila 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_64nolgia-aarch64-unknown-linux-gnuLinux arm64nolgia-x86_64-pc-windows-msvc.exeWindows x86_64nolgia-aarch64-pc-windows-msvc.exeWindows arm64
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
npx skills add nolgiainc/nolgia-skillsRequer Node.js. A CLI de skills detecta o Claude Code, o Cursor, o Codex e outros agentes compatíveis.
GitHub CLI
gh skill install nolgiainc/nolgia-skills --allGitHub CLI 2.90 ou mais recente (o comando está em prévia). Adicione --scope user para instalar em todos os projetos.
Claude Code
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgiaDigite 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 GitHubCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope userO Codex também lê o manifesto de plugin do Codex do repositório quando instalado como plugin.
Pela CLI nolgia
nolgia skills installA 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
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 runbookSDKs 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 · nolgiaCliente tipado gerado a partir do contrato OpenAPI. Importe AuthenticatedClient e chame os módulos nolgia.api.*.
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdkCliente 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.
npm install @nolgia/sdkRust
crates.io · nolgiaCliente 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.
cargo add nolgiaRust CLI
crates.io · nolgia-cliO 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.
cargo install nolgia-cliIní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.

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.pngConstrua com o NOLGIA
Mais do que uma API.
Conecte a plataforma ao seu próprio assistente via MCP, amplie seu agente com Abilities do Marketplace ou deixe o NOLGIA Agent fazer a geração por você.
NOLGIA MCP
Adicione o NOLGIA ao Claude Code ou ao Cursor e gere de dentro do seu próprio assistente.
Conecte seu assistenteMarketplace · Abilities
Instale Abilities prontas que adicionam novas habilidades ao seu agente e aos seus fluxos de trabalho.
Ver o MarketplaceAgent Sessions API
Controle o NOLGIA Agent pelo seu próprio código: sessões, mensagens, streaming, direcionamento, interrupção e perguntas, com helpers de execução em todos os SDKs.
Ler o guia da API Agent SessionsO NOLGIA Agent
Um agente hospedado que usa a mesma API: descreva o plano, e ele gera.
Conheça o AgentPegue 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.

