API サーフェスの整合¶
このサーバーを NovelAI が公開している API ドキュメントと照合した監査結果です。
実際のエンドポイントに対する ライブ検証 も含みます。生成リクエストが検証
エラーで失敗し始めたとき、NovelAI が API 変更を告知したとき、または nai/ に
触れるリリースの前に再実行してください。
公式ドキュメントの実態¶
URL |
提供している内容 |
|---|---|
|
Swagger UI。インライン設定が |
|
これが実際のスペック: Swagger 2.0、27 パス、57 定義、タイトルは “Omegalaser API”。 |
|
同じスペックのバイト単位で同一のコピー。 |
|
Swagger UI ですが、その |
|
“Observability API” (エラートラッキング) であり、画像生成とは無関係です。 |
|
製品ガイド (194 ページ)。機能と UI 設定 を説明するもので、エンドポイントやフィールド名は扱いません。 |
プロジェクト自身のブラウザフィンガープリント付きクライアントでスペックを取得します (Cloudflare は素のクライアントをブロックします):
from novelai_image_mcp.nai.http import create_http_client
async with create_http_client(timeout=60) as client:
spec = (await client.get("https://image.novelai.net/docs/doc.json")).json()
スペックはフィールドのホワイトリストではない¶
image.RequestParameters は、このクライアントが送信し API が受け付けるフィールドを
省略しています — characterPrompts、autoSmea、ucPresetId、qualityPresetId (V5)、
normalize_reference_strength_multiple、inpaintImg2ImgStrength、
legacy_uc、パラメーター単位の use_coords です — さらに model、
sampler、noise_schedule を列挙なしの素の文字列として型付けしています。
スペックは どのパスが存在するか と レスポンスの形 について権威あるものとして扱い、
どのフィールドが機能するか についてはライブ API を権威あるものとして扱ってください。
パスの一覧 (27 件を文書化)¶
2026-10-10 に実アカウントで検証済み (Anlas の消費前後を記録)。
文書化されているパス |
このサーバー |
ライブ結果 |
|---|---|---|
|
V3 / Furry の ZIP パス ( |
|
|
V4 / V4.5 / V5 の msgpack パス |
200 ( |
|
|
200、 |
|
|
このホストでは V5 モデルのみ 200。旧 |
|
|
|
|
|
200 (バイナリの vibe ファイル。クライアントが base64 エンコード) |
|
|
200 |
|
|
200 |
|
— |
200 (メール / 認証 / BAN ステータス) |
|
— |
200 (priority の再補充) |
|
— |
永続トークンでは 401 |
|
— |
永続トークンでは 401 |
|
— |
テキスト生成。この画像サーバーの対象外 |
|
— |
OpenAI 互換のテキスト API。 |
|
— |
アカウント / 製品エンドポイント。変更操作とプライベートデータはこの監査では決して呼び出しません |
|
|
このスペックには含まれません。 |
このコードベースを変更させた知見¶
/ai/upscaleは移行済みで、V5 専用です。 エンドポイントはimage.novelai.net上にあり、{image, model, declared_blur_sigma}を受け取り、 V3/V4/V4.5 のすべてのモデルを “model … doesn’t support standalone upscaling” で拒否します。以前の実装は{image, width, height, scale}をapi.novelai.net/ai/upscaleに POST しており、これは現在 404 を 返します — ツールは壊れていました。upscale()で修正しました: 画像ホストに POST し、文書化されたボディを送信し、モデルの既定値をNOVELAI_UPSCALE_MODEL(nai-diffusion-5-full) にし、4× ステップ以外を 拒否します (API は係数を公開していません)。suggest_tagsは{tag, count, confidence}を返します — ドキュメントが主張していた{description, text, count}の形ではありません。schemas.TagSuggestionはワイヤーフィールドを反映するようになりました (上流の追加が残るようextra="allow"付き)。/ai/generate-image(ZIP) は V4/V4.5 モデルで 500 を返します — これらのモデルは/ai/generate-image-streamを使う必要があります。クライアントは すでにモデルファミリー (is_v4_model()) でルーティングしているため、変更は不要でした。
意図的に未検証¶
emotionDirector ツール: 顔のない合成画像ではリクエストが 500 を返します。 他の 5 つのreq_type値は 200 を返します。確認にはポートレートが必要です。アカウント状態を変更するもの (
/user/consent、subscription/bind、create-persistent-token、objects/*の削除) — 設計上対象外です。/user/giftkeysと/user/clientsettingsは永続トークンでは 401 を返します。 形を文書化するにはセッショントークンが必要です。