開発者ポータル

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 フォーミュラは最新リリースに追従します。

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 で公開している 3 つのスキルが、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

skills リポジトリには 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 には同じ 3 つのスキルが同梱されています。ターゲット:--target claude-user、--target claude-project、--target hermes、または --target dir --dir <path>。

エージェントに貼り付ける

1 行
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 をインストールし、あなたの認証を待ってからスキルをインストールし、確認用の生成を 1 回実行します。

手順書を読む
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 クライアントです。1 回のインストールで必要なものがすべてそろいます。ESM 形式で、充実した TypeScript の型定義付きです。

shell
npm install @nolgia/sdk

Rust

crates.io · nolgia

OpenAPI の契約から生成された tokio ベースの非同期クライアントです。リトライ、型付きエラー、ジョブの待機、アップロードとダウンロードを内蔵しています。インストールは 1 回だけで、ランタイムと serde_json を再エクスポートします。ブロッキングクライアントも feature フラグひとつで使えます。

shell
cargo add nolgia

Rust CLI

crates.io · nolgia-cli

nolgia コマンド:ターミナルから画像、動画、オーディオを生成する Rust 製の単一バイナリです。Rust のコードからは、上の nolgia クレートを使ってください。

shell
cargo install nolgia-cli

クイックスタート

認証して、呼び出す。

PAT でクライアントを作成し、画像生成を送信して、アセットができるまでジョブをロングポーリングします。どの SDK の README も、最初にこの 3 つの呼び出しを紹介しています。Python クライアントは型付きの nolgia.api.* モジュールを公開し、Rust クレートの subscribe は送信と待機を 1 回の呼び出しで行い、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 にするだけ。最初のクレジットは無料です。