Portal para desarrolladores

Desarrolla con NOLGIA.

Una API REST para generar imagen, video y audio, con guías, SDK oficiales en cuatro lenguajes, una CLI y skills para agentes de programación. URL base https://api.nolgia.ai, con autenticación mediante un token de acceso personal.

Un joven escribe en una laptop sobre un pupitre escolar en los exteriores vacíos de un estudio de cine, mientras una grúa coloca detrás de él la fachada de un edificio a tamaño real

Referencia de la API

Siempre al día, generada a partir del contrato OpenAPI.

Cada endpoint, esquema y ejemplo va siempre a la par de la especificación que hace funcionar la plataforma. Explórala y luego autentícate con un token de acceso personal.

Documentación de la API

La referencia OpenAPI completa: endpoints de generación, recursos, trabajos, facturación y cuenta, con esquemas de solicitud y respuesta.

docs.nolgia.ai
Lock

Autenticación

Las solicitudes llevan un token de acceso personal (PAT) como token bearer. Crea uno con un POST a /pat que incluya un nombre. El token en texto plano (con el prefijo nol_) se devuelve una sola vez, así que guárdalo en un lugar seguro.

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

Después envíalo como Authorization: Bearer nol_… en cada solicitud. Un PAT solo gasta créditos de recarga, nunca los créditos mensuales del plan, y los modelos que requieren Pro o superior siguen necesitando ese plan.

Terminal window

CLI

Instala la CLI nolgia.

Un binario de Rust para imagen, video y audio desde tu terminal. Todas las opciones de abajo instalan la misma versión.

Homebrew

shell
brew tap nolgiainc/nolgia && brew install nolgia

macOS y Linux. La fórmula nolgia de nolgiainc/homebrew-nolgia sigue la última versión.

npm

shell
npm install -g @nolgia/cli

Requiere Node 18 o posterior. Descarga el binario precompilado para tu plataforma durante el postinstall.

Instalador de shell

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

Este comando ejecuta un script descargado de la rama main del repositorio y luego descarga un binario de la versión. Si tu entorno exige revisiones o comprobaciones de procedencia, guarda e inspecciona install.sh primero y fija el binario con --tag.

Cargo

shell
cargo install nolgia-cli

Compila desde el código fuente con una cadena de herramientas estable de Rust.

Binarios de la versión

Binarios precompilados para cada plataforma en la versión de 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
Última versión en GitHub
Referencia completa de la CLI
Agent core with orbiting tasks

Skills y plugins

Enséñale NOLGIA a tu agente de programación.

Tres skills, publicadas en nolgiainc/nolgia-skills, enseñan a Claude Code, Cursor y Codex la plataforma, a escribir prompts de video y a crear anuncios UGC. Elige la forma de instalación que use tu agente.

Cualquier agente

shell
npx skills add nolgiainc/nolgia-skills

Requiere Node.js. La CLI de skills detecta Claude Code, Cursor, Codex y otros agentes compatibles.

GitHub CLI

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

GitHub CLI 2.90 o posterior (el comando está en versión preliminar). Agrega --scope user para instalarlo en todos los proyectos.

Claude Code

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

Escribe estos comandos dentro de Claude Code. Registra /nolgia:nolgia-platform, /nolgia:nolgia-video-prompting y /nolgia:nolgia-ugc-ads.

Cursor

El repositorio de skills incluye un manifiesto de plugin para Cursor. El servidor MCP alojado y un comando /nolgia vienen de nolgiainc/cursor-plugin.

nolgiainc/cursor-plugin en GitHub

Codex

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

Codex también lee el manifiesto de plugin de Codex del repositorio cuando se instala como plugin.

Desde la CLI de nolgia

shell
nolgia skills install

La CLI incluye las mismas tres skills. Destinos: --target claude-user, --target claude-project, --target hermes o --target dir --dir <path>.

Pega esto en tu agente

una línea
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.

Tu agente de programación instala la CLI sin sudo, espera mientras te autenticas, instala las skills y ejecuta una generación de verificación.

Lee el runbook
Guía de instalación y código fuente en GitHub
Library of tiles

SDK oficiales

Cuatro clientes, una plataforma.

Instala el cliente para tu stack y empieza a generar en minutos. Todos los SDK usan la misma API.

Python

PyPI · nolgia

Cliente tipado generado a partir del contrato OpenAPI. Importa AuthenticatedClient y llama a los módulos nolgia.api.*.

shell
pip install nolgia

JavaScript / TypeScript

npm · @nolgia/sdk

Cliente openapi-fetch totalmente tipado para Node y el navegador. Una sola instalación trae todo lo que necesita. Se distribuye como ESM con definiciones de TypeScript de primera.

shell
npm install @nolgia/sdk

Rust

crates.io · nolgia

Cliente asíncrono sobre tokio, generado a partir del contrato OpenAPI, con reintentos, errores tipados, espera de trabajos, subidas y descargas integrados. Una sola instalación: reexporta su runtime y serde_json. Un cliente bloqueante está a una feature flag de distancia.

shell
cargo add nolgia

Rust CLI

crates.io · nolgia-cli

El comando nolgia: un único binario de Rust que genera imagen, video y audio desde tu terminal. Para código Rust, usa el crate nolgia de arriba.

shell
cargo install nolgia-cli

Inicio rápido

Autentícate y haz la llamada.

Crea un cliente con tu PAT, envía una generación de imagen y consulta el trabajo con long polling hasta tener el archivo: las mismas tres llamadas con las que empieza el README de cada SDK. El cliente de Python expone módulos tipados nolgia.api.*, subscribe del crate de Rust envía y espera en una sola llamada, y la CLI maneja la plataforma desde tu shell.

Un joven con chaqueta deportiva está sentado tranquilo en una playa con su laptop mientras detrás de él se levanta una ola de la altura de un edificio, dorada por el 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

Consigue un token y empieza a desarrollar.

Crea una cuenta, genera un token de acceso personal y apunta cualquier SDK a NOLGIA. Los primeros créditos corren por nuestra cuenta.