Portal para desarrolladores
Desarrolla con NOLGIA.
Una API REST para generar imagen, vídeo 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.

Guías
Empieza con una guía.
Aprende a usar la plataforma con las guías de docs.nolgia.ai, o genera desde Claude o Cursor con MCP.
Inicio rápido
Instala un cliente y ejecuta tu primera generación.
Lee la guíaAutenticación
Crea un token y autentica las solicitudes a la API.
Lee la guíaTrabajos
Envía una generación y espera su resultado.
Lee la guíaSubidas
Sube archivos de referencia para tus generaciones.
Lee la guíaErrores
Entiende los errores de la API y cómo manejarlos.
Lee la guíaFacturación
Controla los créditos y los costes de generación.
Lee la guíaOrganizaciones
Gestiona el acceso del equipo y los recursos compartidos.
Lee la guíaAgent Sessions API
Crea sesiones y envía mensajes al NOLGIA Agent.
Lee la guíaBibliotecas de cliente
Elige un cliente oficial para tu lenguaje.
Lee la guíaReferencia de la API
Explora cada endpoint y esquema de solicitud de la API.
Abre la referenciallms.txt
Lee el índice de la documentación en texto plano para agentes de programación.
Abre llms.txtReferencia 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.
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.
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.
CLI
Instala la CLI nolgia.
Un binario de Rust para imagen, vídeo y audio desde tu terminal. Todas las opciones de abajo instalan la misma versión.
Homebrew
brew tap nolgiainc/nolgia && brew install nolgiamacOS y Linux. La fórmula nolgia de nolgiainc/homebrew-nolgia sigue la última versión.
npm
npm install -g @nolgia/cliRequiere Node 18 o posterior. Descarga el binario precompilado para tu plataforma durante el postinstall.
Instalador de shell
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bashEste 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
cargo install nolgia-cliCompila 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_64nolgia-aarch64-unknown-linux-gnuLinux arm64nolgia-x86_64-pc-windows-msvc.exeWindows x86_64nolgia-aarch64-pc-windows-msvc.exeWindows arm64
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 vídeo y a crear anuncios UGC. Elige la forma de instalación que use tu agente.
Cualquier agente
npx skills add nolgiainc/nolgia-skillsRequiere Node.js. La CLI de skills detecta Claude Code, Cursor, Codex y otros agentes compatibles.
GitHub CLI
gh skill install nolgiainc/nolgia-skills --allGitHub CLI 2.90 o posterior (el comando está en versión preliminar). Añade --scope user para instalarlo en todos los proyectos.
Claude Code
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgiaEscribe 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 GitHubCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope userCodex también lee el manifiesto de plugin de Codex del repositorio cuando se instala como plugin.
Desde la CLI de nolgia
nolgia skills installLa 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
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 runbookSDK 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 · nolgiaCliente tipado generado a partir del contrato OpenAPI. Importa AuthenticatedClient y llama a los módulos nolgia.api.*.
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdkCliente 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.
npm install @nolgia/sdkRust
crates.io · nolgiaCliente 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.
cargo add nolgiaRust CLI
crates.io · nolgia-cliEl comando nolgia: un único binario de Rust que genera imagen, vídeo y audio desde tu terminal. Para código Rust, usa el crate nolgia de arriba.
cargo install nolgia-cliInicio 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.

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.pngDesarrolla con NOLGIA
Más que una API.
Conecta la plataforma a tu propio asistente por MCP, amplía tu agente con habilidades del Marketplace o deja que el NOLGIA Agent genere por ti.
NOLGIA MCP
Añade NOLGIA a Claude Code o Cursor y genera desde tu propio asistente.
Conecta tu asistenteMarketplace · Habilidades
Instala habilidades listas para usar que suman nuevas capacidades a tu agente y a tus flujos de trabajo.
Explora el MarketplaceAgent Sessions API
Controla el NOLGIA Agent desde tu propio código: sesiones, mensajes, streaming, redirección, interrupción y preguntas, con utilidades de ejecución en cada SDK.
Lee la guía de la Agent Sessions APIEl NOLGIA Agent
Un agente alojado que usa la misma API: describe el plano y genera.
Conoce al agenteConsigue 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.

