NovelAIの拡張口を使う手順：ユーザースクリプトの入れ方と権限、スクリプトから呼べるAI（GLM 4.6）の制限、Persistent API Tokenの扱い、画像の設定の持ち出しを、公式の記述がある範囲だけ並べる

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。

先に結論

• 別のAIとつなぐ公式の手順は、読んだ範囲では見つかりませんでした。 公式ドキュメントの目次（docs.novelai.net/en）に、MCP、外部アシスタント向けのプラグイン、取り込み機能の項目はありません。FAQにも、APIキーやトークンの使い方、第三者のツールの記述はありません。
• 画像生成のAPIの仕様書は、読めませんでした。 api.novelai.net/docs を開いて取得できたのは「Swagger UI」という題名だけで、エンドポイントの一覧や認証の方式は読めていません。そのため、画像生成のAPIの呼び方（URL、送るデータ、返ってくるデータ）は、この記事では書きません。
• 手順を書けるのは、NovelAIの画面の内側にある入口です。 ユーザースクリプトは、画面の中で動く拡張の仕組みで、中から別のAIモデル（GLM 4.6）の文章生成を呼べる、と公式ドキュメントが書いています。AI同士の組み合わせとして読めるのは、ここだけです。
• 「どこへ何が渡るか」は、ページごとに書かれている範囲が違います。 書かれていないものは、「記載が見つからない」と書きます。

前提：用語をそろえる

• ユーザースクリプト：利用者が書いて、NovelAIの画面の中で動かす小さなプログラムです。TypeScript（JavaScriptの上位版）で書きます。
• Web Worker：ブラウザの中で、画面とは別に動くプログラムの実行場所です。公式は、スクリプトがここで隔離されて動く、と書いています。
• フック（hook）：生成の前後などの決まったタイミングで、スクリプトの関数を呼ぶ仕組みです。
• API トークン：プログラムからサービスを呼ぶときの、パスワードのような文字列です。
• MCP：AIエージェントを外部の道具につなぐ規格です。NovelAIの公式資料で、読んだ範囲に記載はありません。
• メタデータ：画像ファイルに一緒に入る、生成の設定の情報です。
• Vibe：Vibe Transferで使う、参照画像から取り出した情報です（06を参照）。

連携の一覧（公式の記述の有無）

連携1：ユーザースクリプトを開く・入れる・止める

手順：スクリプトの画面を開く

公式のScripting導入ページが書いている入口は、3通りです。

1. 画面左のサイドバーの ガチョウのメニュー（goose menu） を開く。
2. 物語を選んでいるときは、右サイドバーの advanced タブから開く。
3. Alt＋X を押す。

開くと User Scripts のモーダル（重なって出る画面）が出ます。公式は、ここでスクリプトの取り込み、作成、変更をする、と書いています。ボタンの表記は、読んだページには書かれていません。「公式で確認できていない」です。

2種類のスクリプト

• スクリプトを実行する順番は、User Scriptsのモーダルに並ぶ順です。アカウントのスクリプトが先、物語のスクリプトが後、と公式のHooksページが書いています。
• 共有の仕組み（公開の場など）は、導入ページに書かれていません。公式の例のファイルは、ダウンロードして取り込む形と読めます（取り込みのボタンの表記は書かれていません）。

手順：公式の例のスクリプトを手に入れる

1. 公式ドキュメントが案内する GitHub の NovelAI/novelai-script-examples を開く。
2. 中身は、scenarios/ と scripts/ のフォルダー、LICENSE（MIT）、README。READMEが挙げる例は、次のとおりです。
3. Scripting Demo（Crystal Dragon Encounter、.scenario）：多くの機能を見せるシナリオ
4. Bookmarks：物語の履歴の位置を保存して戻る
5. Editor Probabilities Everywhere：右クリックで、次のトークンの確率を見る
6. Find & Replace：検索と置換
7. Joke Generator：APIで文章を生成する基本の例
8. Notes：エディターの下にメモのパネルを足す
9. Smart Summarizer：選んだ文章の要約を、右クリックで出す
10. Thought Generator：登場人物の考えを、物語の文脈から生成する
11. Retry Harder：特別なプロンプトを使うもう1つのリトライボタン
12. TTS with Character Voices：登場人物ごとの声で読み上げる
13. ファイルは .naiscript と .scenario の形式です。導入ページは、リンク先のファイルが新しいタブで開いたら、保存するか、ページを保存するよう書いています。
14. 取り込みの手順（User Scriptsのモーダルのどのボタンか）は、READMEにも導入ページにも書かれていません。「公式で確認できていない」です。

注意：このリポジトリのページは、自分から「公式」とは書いていません。NovelAIのGitHub組織の下にあり、公式のスクリプトのドキュメントが案内しているリポジトリです。

手順：スクリプトで画面がおかしくなったとき

公式の導入ページが書いている手順です。

1. URLの末尾に ?noscript=true を付ける。
2. ページを読み込み直す。スクリプトが読み込まれなくなる。
3. User Scriptsのモーダルを開き、問題のスクリプトを無効にするか、取り除く。

スクリプトにできないこと（公式の制限）

• 任意のネットワーク通信はできない。
• ほとんどのアカウント情報には触れない。
• DOM（画面の部品）を直接いじれない。スクリプト用に決められた場所以外は変えられない。
• いつでも読み込みが解除される（無効にしたとき、物語を切り替えたとき、モーダルを閉じたとき）。大事なデータは、メモリではなくStorage APIに置く。
• 約束（Promise）のエラーは、画面にもコンソールにも出ない。.catch か try/catch で拾う。
• 開発の補助として、型の定義ファイル http://novelai.net/scripting/types/script-types.d.ts が案内されています。

権限（Permissions）：スクリプトがユーザーに許可を求める

公式のPermissionsのページが書いていることです。

公式の例（短いもの）：

let granted = await api.v1.permissions.request('storyEdit');

• 読んだページに権限名として出ていたのは、storyEdit、documentEdit、clipboardWrite、editorDecorations です。API Referenceが、storyEdit は作者のメモを設定する an.set()、documentEdit は文書を書き換える各メソッド、clipboardWrite はクリップボードへの書き込み、editorDecorations は印やウィジェットの作成に必要、と書いています。
• 権限の全一覧、各権限が許す範囲、ユーザーが後から取り消す画面は、読んだページに書かれていません。 「記載が見つからない」です。

スクリプトの「外し方」

• スクリプトを外す：User Scriptsのモーダルで、無効にするか、取り除く（導入ページの ?noscript=true の説明が、この2つに触れています）。
• 許可した権限の取り消し：記載が見つからない。
• 物語のスクリプトは、その物語のファイルに保存されます。物語を書き出すと一緒に出ていく可能性がありますが、書き出しにスクリプトが含まれるかは、読んだページに書かれていません。

連携2：スクリプトから、別のAIモデル（GLM 4.6）に文章を生成させる

公式が書いていること

• 残りの量を調べる関数：api.v1.script.getAllowedOutput、getAllowedInput、getTimeUntilAllowedOutput、getTimeUntilAllowedInput、waitForAllowedOutput、waitForAllowedInput、countUncachedInputTokens。
• 入力が上限に近づいたときの工夫として、api.v1.createRolloverHelper が用意されている（古いメッセージを落として、前の部分のキャッシュを保つ）。
• Anlasなどの費用と、生成に必要な権限は、読んだGenerating Textのページに書かれていません。 「記載が見つからない」です。

この記事の例（動作は確かめていません）

公式のページが書いている呼び方に合わせて、この記事で組んだ最小の形です。公式の例の写しではありません。

const response = await api.v1.generate(
  [{ role: "user", content: "Write one sentence about a lighthouse." }],
  { model: "glm-4-6", max_tokens: 100 }
);
api.v1.log(response.choices[0].text);

• 公式の基本の例が、api.v1.generate( で始まり、response.choices[0].text をログに出して終わる、という点は、ページの要約から読めました。引数の細部は、公式の原文で確かめてください。

フック（hooks）：生成のタイミングに割り込む

api.v1.hooks.register(フック名, 関数) で登録します。1つのスクリプトは、1つのフックにつき、1つの関数だけ持てます（再登録すると置き換わる）。

• stopFurtherScripts は、後のスクリプトにそのフックを渡さない。stopGeneration は、生成を止めて、以後のフックも止める。

画面の部品を足す（UI拡張）

• 種類：contextMenuButton、toolbarButton、toolboxOption、scriptPanel、sidebarPanel、lorebookPanel。
• api.v1.ui.register に、type を持つ部品の配列を渡して登録し、api.v1.ui.update でIDを使って更新します。
• この記事の例（公式の例を要約から組み直したもので、動作は確かめていません）：

api.v1.ui.register([{ type: 'toolbarButton', text: 'Example Button', callback: () => api.v1.log('Clicked') }])

• 値の保存先：api.v1.storage（アカウント）、storyStorage（物語）、tempStorage、historyStorage が、API Referenceの一覧にあります。それぞれの保存の範囲や寿命は、この記事では読んでいません。

スクリプトとAIの間で渡るデータ

• スクリプトが api.v1.generate に渡したメッセージが、モデルの生成に使われる、という流れは、ページから読めます。送り先の運営、保存、記録の扱いは、Generating Textのページには書かれていません。プライバシーポリシーでの扱い（文章生成の要求は、保存・記録されずHTTPSで送られる、など）は、03で整理しました。
• 公式の制限として、スクリプトは「任意のネットワーク通信」はできないと書かれています（特定の通信が許されるかは、記載が見つからない）。

連携3：Persistent API Token（ボタンの場所と性質まで）

手順

1. User Settingsの Account を開く。（経路は、FAQが「User Settings>Account」、Subscriptionページが「user settings メニューの Account」と書いています。手元の画面と照らしてください。）
2. Get Persistent API Token を押す。
3. 出たポップアップのトークンを、閉じる前に控える。閉じると、二度と見られません。
4. 新しく作り直すと、前のトークンは無効になります。

公式の記述の範囲

• このため、「トークンを使ってNovelAIの画像を自動でつくる」手順は、この記事では書けません。
• 僕らの見立て（公式の手順ではありません）：トークンは、パスワードと同じ扱いで、他人に見せない、公開の場所に書かない、という前提で扱う案が考えられます。使う予定がなければ、作らずにおく案もあります。
• 03で触れたとおり、利用規約には、自動化の仕組みやアカウントの共有・貸し出しに関する条文があります。使う前に、原文を確かめてください（この記事では規約を読み直していません）。

連携4：画像の設定・参照画像を持ち出す

メタデータつきで保存し、戻す（FAQ、チュートリアル）

1. 画像の下の 保存アイコン で保存する。右クリックの保存やクリップボードでは、プロンプト・seed・設定が入りません。
2. 戻すとき：保存した画像を、NovelAIのサイトにドラッグ＆ドロップする。または novelai.net/inspect の検査ツールを使う。
3. seedも読み込まれるのが既定です。違う絵がほしいときは、seedの値を押して消します。

別の道具の側から設定を読む方法は、公式の資料の範囲では確認できていません。

Vibeの書き出し・読み込み（Vibe Transferのページ、V4以上）

1. 画像をvibeとして入れ、エンコードする。
2. .naiv4vibe：エンコードのあとにダウンロードする。元画像、サムネイル、使った値のエンコードが入る。読み込みは、ふつうのVibe Transferの画像と同じように、ドラッグして戻す。
3. Export Bundle：現在のvibeを1つの .naiv4vibeBundle にまとめる。
4. Export as Encodings：サムネイルや調整の選択肢のない形で書き出す。
5. PNGをDownloadで保存すると、vibeが画像に埋め込まれる。貼り付けでは入りません。読み込むとき、今のvibeを置き換えるか、Append（追加）を選ぶ。
6. 埋め込まれたvibeは、エンコード済みなので、エンコードの費用はかからない。ただし Information Extracted の値は変えられない。

Canvasのファイル（Canvasのページ）

• Download File で書き出し、あとで Upload Image で読み込める。

連携5：物語を持ち出す

• 1つずつの書き出しの画面の手順と、取り込み先の別サービスは、読んだページに書かれていません。
• 解約後の書き出しの期限は、04を参照してください。

うまくいかないときの確認点

気をつけること

• この記事は、実際に使って確かめた記録ではありません。公式ドキュメントの要約を読んだ範囲です。
• 読めなかったページ：api.novelai.net/docs（題名「Swagger UI」のみ）、novelai.net/trial（題名とメタ情報のみ）。API Referenceのページは、後半（約1万字）を読んでいません。
• 「外部のAIとつなぐ公式の入口がない」とは断定しません。読んだページに見つからなかった、という意味です。
• 「画像生成のAPIがない」とも断定しません。スクリプトのAPI一覧にない、API仕様書を読めていない、という意味です。
• スクリプトの権限は、読んだページに全体が書かれていません。取り込む前に、中身（TypeScript）を読める人は読むよう案内している公式の記述は、見つかりませんでした。他人が書いたスクリプトを入れる前の確認は、利用者の判断になります。
• GitHubの novelai-script-examples は、自分では「公式」と書いていません。MITライセンスで、NovelAIの組織の下にあります。
• NovelAIの外の第三者のツールに、パスワードやトークンを渡す場合の安全性は、公式の資料では確認できていません。
• 規約は変わります。この記事は法律の助言ではありません。

出典

• NovelAI Documentation（トップ・目次、NovelAI、確認日 2026-10-25）
• User Scripting: Introduction（NovelAI Documentation、確認日 2026-10-25）
• Scripting: API Reference（NovelAI Documentation、確認日 2026-10-25。後半は未読）
• Scripting: Generating Text（NovelAI Documentation、確認日 2026-10-25）
• Scripting: Hooks（NovelAI Documentation、確認日 2026-10-25）
• Scripting: Permissions（NovelAI Documentation、確認日 2026-10-25）
• Scripting: UI Extensions（NovelAI Documentation、確認日 2026-10-25）
• novelai-script-examples（GitHub、NovelAI組織、確認日 2026-10-25）
• Account（NovelAI Documentation、確認日 2026-10-25）
• FAQ（NovelAI Documentation、確認日 2026-10-25）
• Vibe Transfer（NovelAI Documentation、確認日 2026-10-25）
• Canvas（NovelAI Documentation、確認日 2026-10-25）
• Tutorial: Intro to Image Generation（NovelAI Documentation、確認日 2026-10-25）