개발자 포털

NOLGIA로 개발하세요.

이미지, 동영상, 오디오 생성을 위한 하나의 REST API. 가이드, 4개 언어 공식 SDK, CLI, 코딩 에이전트용 스킬을 함께 제공해요. 기본 URL은 https://api.nolgia.ai이고, 개인 액세스 토큰으로 인증해요.

텅 빈 스튜디오 야외 세트장에서 젊은 남자가 학교 책상에 앉아 노트북을 두드리는 동안, 뒤에서는 크레인이 실물 크기의 건물 정면을 내려 제자리에 놓아요

API 레퍼런스

OpenAPI 계약으로 생성한 실시간 문서.

모든 엔드포인트, 스키마, 예시는 플랫폼을 움직이는 스펙과 항상 일치해요. 둘러본 다음 개인 액세스 토큰으로 인증하세요.

API 문서

전체 OpenAPI 레퍼런스: 생성, 에셋, 작업, 결제, 계정 엔드포인트와 요청 및 응답 스키마.

docs.nolgia.ai
Lock

인증

요청에는 개인 액세스 토큰(PAT)을 Bearer 토큰으로 담아요. 이름과 함께 /pat에 POST하면 발급돼요. 평문 토큰(nol_ 접두사)은 한 번만 반환되니 안전하게 보관하세요.

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

그다음 모든 요청에 Authorization: Bearer nol_…로 보내세요. PAT는 충전 크레딧만 쓰고 월간 요금제 크레딧은 절대 쓰지 않으며, Pro 이상이 필요한 모델은 여전히 해당 요금제가 있어야 해요.

Terminal window

CLI

nolgia CLI를 설치하세요.

터미널에서 이미지, 동영상, 오디오를 만드는 Rust 바이너리 하나. 아래 어떤 방법으로 설치해도 같은 릴리스예요.

Homebrew

shell
brew tap nolgiainc/nolgia && brew install nolgia

macOS와 Linux. nolgiainc/homebrew-nolgia의 nolgia formula가 최신 릴리스를 따라가요.

npm

shell
npm install -g @nolgia/cli

Node 18 이상이 필요해요. postinstall 중에 플랫폼에 맞는 사전 빌드 바이너리를 다운로드해요.

셸 설치 프로그램

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

이 명령은 저장소의 main 브랜치에서 가져온 스크립트를 실행한 다음 릴리스 바이너리를 다운로드해요. 환경상 검토나 출처 확인이 필요하다면 먼저 install.sh를 저장해 검사하고, --tag로 바이너리 버전을 고정하세요.

Cargo

shell
cargo install nolgia-cli

안정 버전 Rust 툴체인으로 소스에서 빌드해요.

릴리스 바이너리

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
GitHub의 최신 릴리스
전체 CLI 레퍼런스
Agent core with orbiting tasks

스킬과 플러그인

코딩 에이전트에게 NOLGIA를 가르치세요.

nolgiainc/nolgia-skills에 공개된 세 가지 스킬이 Claude Code, Cursor, Codex에 플랫폼, 동영상 프롬프팅, UGC 광고를 가르쳐요. 에이전트에 맞는 설치 방법을 고르세요.

모든 에이전트

shell
npx skills add nolgiainc/nolgia-skills

Node.js가 필요해요. skills CLI가 Claude Code, Cursor, Codex 등 지원하는 에이전트를 감지해요.

GitHub CLI

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

GitHub CLI 2.90 이상(이 명령은 미리보기 단계예요). 모든 프로젝트에 설치하려면 --scope user를 추가하세요.

Claude Code

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

Claude Code 안에서 이 명령을 입력하세요. /nolgia:nolgia-platform, /nolgia:nolgia-video-prompting, /nolgia:nolgia-ugc-ads가 등록돼요.

Cursor

스킬 저장소에는 Cursor 플러그인 매니페스트가 들어 있어요. 호스팅 MCP 서버와 /nolgia 명령은 nolgiainc/cursor-plugin에서 제공해요.

GitHub의 nolgiainc/cursor-plugin

Codex

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

Codex는 플러그인으로 설치하면 저장소의 Codex 플러그인 매니페스트도 읽어요.

nolgia CLI에서

shell
nolgia skills install

CLI에도 같은 세 가지 스킬이 들어 있어요. 대상: --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를 설치하고, 인증하는 동안 기다렸다가, 스킬을 설치하고, 확인용 생성을 한 번 실행해요.

런북 읽기
GitHub의 설치 가이드와 소스
Library of tiles

공식 SDK

클라이언트 4개, 플랫폼 하나.

스택에 맞는 클라이언트를 설치하고 몇 분 만에 생성을 시작하세요. 모든 SDK가 같은 API를 대상으로 해요.

Python

PyPI · nolgia

OpenAPI 계약으로 생성한 타입 지정 클라이언트예요. AuthenticatedClient를 가져와 nolgia.api.* 모듈을 호출하세요.

shell
pip install nolgia

JavaScript / TypeScript

npm · @nolgia/sdk

Node와 브라우저용으로 완전히 타입이 지정된 openapi-fetch 클라이언트예요. 한 번 설치로 필요한 모든 것이 따라와요. ESM과 완벽한 TypeScript 정의를 제공해요.

shell
npm install @nolgia/sdk

Rust

crates.io · nolgia

OpenAPI 계약으로 생성한 tokio 기반 비동기 클라이언트로, 재시도, 타입이 지정된 오류, 작업 대기, 업로드와 다운로드를 기본 제공해요. 한 번 설치로 끝나요: 런타임과 serde_json을 다시 내보내요. 블로킹 클라이언트는 기능 플래그 하나만 켜면 돼요.

shell
cargo add nolgia

Rust CLI

crates.io · nolgia-cli

nolgia 명령: 터미널에서 이미지, 동영상, 오디오를 생성하는 Rust 바이너리 하나예요. Rust 코드에서는 위의 nolgia 크레이트를 쓰세요.

shell
cargo install nolgia-cli

빠른 시작

인증하고 호출하세요.

PAT로 클라이언트를 만들고, 이미지 생성을 제출한 뒤, 작업을 롱 폴링해 에셋을 받으세요. 각 SDK README의 첫머리에 나오는 세 가지 호출 그대로예요. Python 클라이언트는 타입이 지정된 nolgia.api.* 모듈을 제공하고, Rust 크레이트의 subscribe는 제출과 대기를 한 번에 처리하며, CLI는 셸에서 플랫폼을 다뤄요.

해변에 트랙 재킷을 입은 젊은 남자가 노트북을 들고 차분히 앉아 있고, 뒤로는 건물 높이의 파도가 햇빛에 금빛으로 물들며 솟아올라요
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

토큰을 받고 개발을 시작하세요.

계정을 만들고, 개인 액세스 토큰을 발급하고, 원하는 SDK를 NOLGIA에 연결하세요. 첫 크레딧은 무료로 드려요.