빠른 시작
클라이언트를 설치하고 첫 생성을 실행하세요.
가이드 읽기인증
토큰을 만들고 API 요청을 인증하세요.
가이드 읽기작업
생성을 제출하고 결과를 기다리세요.
가이드 읽기업로드
생성에 쓸 레퍼런스 파일을 업로드하세요.
가이드 읽기오류
API 오류와 처리 방법을 알아보세요.
가이드 읽기결제
크레딧과 생성 비용을 추적하세요.
가이드 읽기조직
팀 접근 권한과 공유 리소스를 관리하세요.
가이드 읽기Agent Sessions API
세션을 만들고 NOLGIA Agent에 메시지를 보내세요.
가이드 읽기클라이언트 라이브러리
사용하는 언어에 맞는 공식 클라이언트를 고르세요.
가이드 읽기API 레퍼런스
모든 API 엔드포인트와 요청 스키마를 살펴보세요.
레퍼런스 열기llms.txt
코딩 에이전트용 일반 텍스트 문서 색인을 읽어 보세요.
llms.txt 열기API 레퍼런스
OpenAPI 계약으로 생성한 실시간 문서.
모든 엔드포인트, 스키마, 예시는 플랫폼을 움직이는 스펙과 항상 일치해요. 둘러본 다음 개인 액세스 토큰으로 인증하세요.
API 문서
전체 OpenAPI 레퍼런스: 생성, 에셋, 작업, 결제, 계정 엔드포인트와 요청 및 응답 스키마.
인증
요청에는 개인 액세스 토큰(PAT)을 Bearer 토큰으로 담아요. 이름과 함께 /pat에 POST하면 발급돼요. 평문 토큰(nol_ 접두사)은 한 번만 반환되니 안전하게 보관하세요.
curl -X POST https://api.nolgia.ai/pat -d '{"name":"my-cli"}'그다음 모든 요청에 Authorization: Bearer nol_…로 보내세요. PAT는 충전 크레딧만 쓰고 월간 요금제 크레딧은 절대 쓰지 않으며, Pro 이상이 필요한 모델은 여전히 해당 요금제가 있어야 해요.
CLI
nolgia CLI를 설치하세요.
터미널에서 이미지, 동영상, 오디오를 만드는 Rust 바이너리 하나. 아래 어떤 방법으로 설치해도 같은 릴리스예요.
Homebrew
brew tap nolgiainc/nolgia && brew install nolgiamacOS와 Linux. nolgiainc/homebrew-nolgia의 nolgia formula가 최신 릴리스를 따라가요.
npm
npm install -g @nolgia/cliNode 18 이상이 필요해요. postinstall 중에 플랫폼에 맞는 사전 빌드 바이너리를 다운로드해요.
셸 설치 프로그램
curl -fsSL https://raw.githubusercontent.com/nolgiainc/nolgia-cli/main/install.sh | bash이 명령은 저장소의 main 브랜치에서 가져온 스크립트를 실행한 다음 릴리스 바이너리를 다운로드해요. 환경상 검토나 출처 확인이 필요하다면 먼저 install.sh를 저장해 검사하고, --tag로 바이너리 버전을 고정하세요.
Cargo
cargo install nolgia-cli안정 버전 Rust 툴체인으로 소스에서 빌드해요.
릴리스 바이너리
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
스킬과 플러그인
코딩 에이전트에게 NOLGIA를 가르치세요.
nolgiainc/nolgia-skills에 공개된 세 가지 스킬이 Claude Code, Cursor, Codex에 플랫폼, 동영상 프롬프팅, UGC 광고를 가르쳐요. 에이전트에 맞는 설치 방법을 고르세요.
모든 에이전트
npx skills add nolgiainc/nolgia-skillsNode.js가 필요해요. skills CLI가 Claude Code, Cursor, Codex 등 지원하는 에이전트를 감지해요.
GitHub CLI
gh skill install nolgiainc/nolgia-skills --allGitHub CLI 2.90 이상(이 명령은 미리보기 단계예요). 모든 프로젝트에 설치하려면 --scope user를 추가하세요.
Claude Code
/plugin marketplace add nolgiainc/nolgia-skills
/plugin install nolgia@nolgiaClaude Code 안에서 이 명령을 입력하세요. /nolgia:nolgia-platform, /nolgia:nolgia-video-prompting, /nolgia:nolgia-ugc-ads가 등록돼요.
Cursor
스킬 저장소에는 Cursor 플러그인 매니페스트가 들어 있어요. 호스팅 MCP 서버와 /nolgia 명령은 nolgiainc/cursor-plugin에서 제공해요.
GitHub의 nolgiainc/cursor-pluginCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope userCodex는 플러그인으로 설치하면 저장소의 Codex 플러그인 매니페스트도 읽어요.
nolgia CLI에서
nolgia skills installCLI에도 같은 세 가지 스킬이 들어 있어요. 대상: --target claude-user, --target claude-project, --target hermes, 또는 --target dir --dir <path>.
에이전트에 붙여넣기
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.코딩 에이전트가 sudo 없이 CLI를 설치하고, 인증하는 동안 기다렸다가, 스킬을 설치하고, 확인용 생성을 한 번 실행해요.
런북 읽기공식 SDK
클라이언트 4개, 플랫폼 하나.
스택에 맞는 클라이언트를 설치하고 몇 분 만에 생성을 시작하세요. 모든 SDK가 같은 API를 대상으로 해요.
Python
PyPI · nolgiaOpenAPI 계약으로 생성한 타입 지정 클라이언트예요. AuthenticatedClient를 가져와 nolgia.api.* 모듈을 호출하세요.
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdkNode와 브라우저용으로 완전히 타입이 지정된 openapi-fetch 클라이언트예요. 한 번 설치로 필요한 모든 것이 따라와요. ESM과 완벽한 TypeScript 정의를 제공해요.
npm install @nolgia/sdkRust
crates.io · nolgiaOpenAPI 계약으로 생성한 tokio 기반 비동기 클라이언트로, 재시도, 타입이 지정된 오류, 작업 대기, 업로드와 다운로드를 기본 제공해요. 한 번 설치로 끝나요: 런타임과 serde_json을 다시 내보내요. 블로킹 클라이언트는 기능 플래그 하나만 켜면 돼요.
cargo add nolgiaRust CLI
crates.io · nolgia-clinolgia 명령: 터미널에서 이미지, 동영상, 오디오를 생성하는 Rust 바이너리 하나예요. Rust 코드에서는 위의 nolgia 크레이트를 쓰세요.
cargo install nolgia-cli빠른 시작
인증하고 호출하세요.
PAT로 클라이언트를 만들고, 이미지 생성을 제출한 뒤, 작업을 롱 폴링해 에셋을 받으세요. 각 SDK README의 첫머리에 나오는 세 가지 호출 그대로예요. Python 클라이언트는 타입이 지정된 nolgia.api.* 모듈을 제공하고, Rust 크레이트의 subscribe는 제출과 대기를 한 번에 처리하며, CLI는 셸에서 플랫폼을 다뤄요.

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.pngNOLGIA로 개발하기
API 그 이상.
MCP로 내 어시스턴트에 플랫폼을 연결하거나, Marketplace의 어빌리티로 에이전트를 확장하거나, NOLGIA Agent에게 생성을 맡기세요.
NOLGIA MCP
Claude Code나 Cursor에 NOLGIA를 추가하고 내 어시스턴트 안에서 바로 생성하세요.
어시스턴트 연결Marketplace · 어빌리티
에이전트와 워크플로에 새 기능을 더하는 기성 어빌리티를 설치하세요.
Marketplace 둘러보기Agent Sessions API
내 코드로 NOLGIA Agent를 다루세요: 세션, 메시지, 스트리밍, 방향 조정, 중단, 질문, 그리고 모든 SDK의 실행 헬퍼까지.
Agent Sessions API 가이드 읽기NOLGIA Agent
같은 API를 쓰는 호스팅 에이전트: 샷을 설명하면 바로 생성해요.
Agent 만나 보기

