開発者ポータル
NOLGIA で開発する。
画像、動画、オーディオ生成のためのひとつの REST API。ガイド、4 言語の公式 SDK、CLI、コーディングエージェント向けスキルを用意しています。ベース URL は https://api.nolgia.ai、認証には個人アクセストークンを使います。

クイックスタート
クライアントをインストールして、最初の生成を実行します。
ガイドを読む認証
トークンを作成して 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 フォーミュラは最新リリースに追従します。
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 で公開している 3 つのスキルが、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
skills リポジトリには Cursor のプラグインマニフェストが含まれています。ホスト型 MCP サーバーと /nolgia コマンドは nolgiainc/cursor-plugin から提供されます。
GitHub の nolgiainc/cursor-pluginCodex
gh skill install nolgiainc/nolgia-skills --all --agent codex --scope userプラグインとしてインストールした場合、Codex はリポジトリの Codex プラグインマニフェストも読み込みます。
nolgia CLI から
nolgia skills installCLI には同じ 3 つのスキルが同梱されています。ターゲット:--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 をインストールし、あなたの認証を待ってからスキルをインストールし、確認用の生成を 1 回実行します。
手順書を読む公式 SDK
4 つのクライアント、ひとつのプラットフォーム。
お使いのスタックに合ったクライアントをインストールすれば、数分で生成を始められます。どの SDK も同じ API を対象にしています。
Python
PyPI · nolgiaOpenAPI の契約から生成された型付きクライアントです。AuthenticatedClient をインポートして、nolgia.api.* モジュールを呼び出します。
pip install nolgiaJavaScript / TypeScript
npm · @nolgia/sdkNode とブラウザ向けの、完全に型付けされた openapi-fetch クライアントです。1 回のインストールで必要なものがすべてそろいます。ESM 形式で、充実した TypeScript の型定義付きです。
npm install @nolgia/sdkRust
crates.io · nolgiaOpenAPI の契約から生成された tokio ベースの非同期クライアントです。リトライ、型付きエラー、ジョブの待機、アップロードとダウンロードを内蔵しています。インストールは 1 回だけで、ランタイムと serde_json を再エクスポートします。ブロッキングクライアントも feature フラグひとつで使えます。
cargo add nolgiaRust CLI
crates.io · nolgia-clinolgia コマンド:ターミナルから画像、動画、オーディオを生成する Rust 製の単一バイナリです。Rust のコードからは、上の nolgia クレートを使ってください。
cargo install nolgia-cliクイックスタート
認証して、呼び出す。
PAT でクライアントを作成し、画像生成を送信して、アセットができるまでジョブをロングポーリングします。どの SDK の README も、最初にこの 3 つの呼び出しを紹介しています。Python クライアントは型付きの nolgia.api.* モジュールを公開し、Rust クレートの subscribe は送信と待機を 1 回の呼び出しで行い、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 でプラットフォームをお使いのアシスタントに接続したり、マーケットプレイスのアビリティでエージェントを拡張したり、NOLGIA Agent に生成を任せたりできます。
NOLGIA MCP
Claude Code や Cursor に NOLGIA を追加して、お使いのアシスタントの中から生成できます。
アシスタントを接続マーケットプレイス · アビリティ
既製のアビリティをインストールして、エージェントやワークフローに新しいスキルを追加できます。
マーケットプレイスを見るAgent Sessions API
自分のコードから NOLGIA Agent を操作できます。セッション、メッセージ、ストリーミング、ステアリング、中断、質問に対応し、すべての SDK に実行ヘルパーがあります。
Agent Sessions API ガイドを読むNOLGIA Agent
同じ API を操作するホスト型エージェント。ショットを説明すれば、生成してくれます。
エージェントを知る
