NovelAI Image MCP

Annotate an image with a ControlNet preprocessor. ``image`` is a base64-encoded PNG/JPEG. ``model`` is one of: ``hed`` (palette swap), ``midas`` (form lock / depth), ``fake_scribble`` (scribbler), ``mlsd`` (building control), ``uniformer`` (landscaper). The returned image is the annotation (e.g. a line-art map) suitable for use as a ControlNet condition in a subsequent generation.

Apply a NovelAI Director tool to an image. ``tool`` is one of: ``lineart``, ``sketch``, ``bg-removal``, ``declutter``, ``colorize``, ``emotion``. ``image`` is a base64-encoded PNG/JPEG. The ``emotion`` tool additionally requires an ``emotion`` name (e.g. ``happy``, ``sad``) and accepts an ``emotion_level`` (0-5, where 0 is normal intensity and 5 is weakest). ``prompt`` guides ``colorize`` and ``emotion``; ``defry`` (0-10) sharpens line art.

Encode a reference image into a NovelAI vibe token. ``reference`` is a base64-encoded PNG/JPEG to encode. ``information_extracted`` (0.01-1.0) controls how strongly the vibe captures the reference's identity (lower = more stylistic, higher = more literal). ``model`` must be a V4/V4.5 model (vibes are not supported on V3, and V5 does not support vibe transfer yet). Returns a base64 vibe token suitable for the ``references`` parameter of ``generate_image``.

Estimate the Anlas cost of a generation without calling the API. Mirrors NovelAI's public web-client cost formula. ``action`` is one of ``generate``, ``img2img``, ``infill`` (inpaint). For ``img2img``, ``strength`` (0.01-0.99) scales the cost proportionally. ``smea`` / ``smea_dynamic`` / ``auto_smea`` apply the SMEA multiplier. ``opus`` grants a free sample when the request is within Opus limits. Returns ``{"anlas": <cost>, "opus_free_sample": <bool>}``. Note: on V5 models, Opus free generations are capped by NovelAI's refillable "battery" usage limit (normal resolution, <=28 steps); once exhausted the API silently bills Anlas instead of erroring, so check ``get_subscription``'s ``usage`` field before costly V5 runs.

Generate one or more images from a text prompt (text-to-image). Supports NovelAI V3 / V4 / V4.5 / V5 models. Pass ``references`` as a list of base64-encoded PNG/JPEG strings to apply vibe transfer (V4/V4.5 only - V5 does not support vibe transfer yet and rejects it). V5 models additionally accept English/Japanese natural-language prompts and the ``straight_alpha`` flag for true transparency (pair it with prompt tags such as ``transparent background`` or ``has alpha``). ``character_prompts`` enables multi-character composition with per-character prompts and center coordinates (x, y in 0.1-0.9). Dimensions are rounded up to the nearest multiple of 64.

Return the account subscription details and Anlas balance. The shape mirrors NovelAI's ``/user/subscription`` response: it includes ``tier`` (0 = free, 1 = starter, 2 = ...), ``active``, the ``trainingStepsLeft`` breakdown, ``fixedTrainingStepsLeft``, ``perStepUsage`` flag, and ``subscriptionId``. Use this to inspect remaining Anlas or the active plan before a generation.

Return the authenticated account's user data. Includes ``email``, ``accountChain`` (registration source), and the ``priority`` epoch. Useful to confirm which account the server is authenticated as before issuing generation commands.

Generate a new image conditioned on an input image (image-to-image). ``image`` is a base64-encoded PNG/JPEG. ``strength`` (0.01-0.99) controls how far the result diverges from the input; ``noise`` (0-0.99) adds extra variation. The model must match the input image domain.

Inpaint (locally redraw) a region of an image. ``image`` and ``mask`` are base64-encoded PNG/JPEG; the mask marks the region to regenerate (non-transparent pixels are redrawn). Requires an inpainting model such as ``nai-diffusion-4-5-full-inpainting`` or ``nai-diffusion-5-full-inpainting``.

Suggest NovelAI tags that complete or refine a prompt. ``prompt`` is the partial prompt text to complete. ``model`` selects the tagger vocabulary (default ``nai-diffusion-4-5-full``). ``language`` is the ISO 639-1 code for the response language (e.g. ``en``, ``ja``). Returns tag suggestions carrying the tag string, its training-set occurrence ``count`` and the tagger's ``confidence``.

Upscale an image 4x using NovelAI's standalone upscaler. ``image`` is a base64-encoded PNG/JPEG. NovelAI's standalone upscaler offers a single 4x step — the API exposes no scaling factor — so ``factor`` only accepts ``4``. The upscaler runs on the V5 model configured by ``NOVELAI_UPSCALE_MODEL`` (default ``nai-diffusion-5-full``) and consumes Anlas based on the source resolution.