NOLGIA

Create a project to group related assets, typically one per campaign, client or scene. Use this before a batch of generations, so each one can be filed with project_id as it is made instead of being sorted out afterwards. Returns the created project.

nolgia_create_project

Cut chosen video ranges into new clips, with a centered 9:16 crop or the original aspect ratio. Renders in the background without spending credits. Each clip returns a render id; its finished video asset appears in the library. Use nolgia_list_assets to find finished clips.

nolgia_create_clips

Delete a saved character. Use this only on an explicit request. The character's reference image assets are kept and are not deleted with it. Returns {deleted: true}.

nolgia_delete_character

Delete a project. Use this only on an explicit request. The grouping goes; the member assets are never deleted with it. Returns {deleted: true}.

nolgia_delete_project

Delete a saved style. Use this only on an explicit request. Its reference image assets are kept. Costs no credits and returns deleted: true.

nolgia_delete_style

Get one ZIP of a finished Encore run: the edit, its compare file, its poster and any 9:16 copy. Returns a short-lived download link with the file list and size. Free, and it changes nothing in the run or the library: the ZIP is packed once and handed out again. Give the link to the person as it is; changing its query string breaks it.

nolgia_encore_download

Get one ZIP of a Multicam job: the original take and every finished angle's clip, named by angle (00-original-take.mp4, 01-wide.mp4 and so on). Returns a short-lived download link with the file list and size. Free, and it changes nothing in the job or the library: the ZIP is packed once and the same file is handed out again until an angle changes. Needs at least one finished angle. Give the link to the person as it is; changing its query string breaks it.

nolgia_multicam_download

Estimate the cost of the next edit step (next_step_credits, priced by the API for the given or default model, quality and render_quality) and the credits the chain has spent so far (chain_credits). Read-only and free; nothing is generated.

nolgia_estimate_edit_session

Bring the person's own clip into their NOLGIA library from a direct link, for Encore: above all the edit the flagship (preset encore, "Paste the edit") scans and remakes with them in it. The link must be a direct https link to an MP4, MOV or WebM file of up to 300 MB; pages on platforms whose terms forbid downloading their videos (TikTok, Instagram, YouTube, X, Facebook, Vimeo and others) are refused without being fetched, so ask the person to save the clip they made and attach it here instead (nolgia_add_chat_files). statement must be true, and only once the person has said they made the clip or hold the rights to it and its audio: ask them in those words. Free; it saves a new video and changes nothing else. Returns its asset_id, for the flagship's inputs.reference or any video slot.

nolgia_encore_link_clip

Find strong standalone moments to post as vertical shorts. Transcribe the video with nolgia_transcribe_asset first. Spends about 1 credit. Returns ranked start and end times, titles and hook reasons, ready for nolgia_create_clips.

nolgia_suggest_clips

Turn one to four photos of an OBJECT into a textured 3D model (a GLB file) saved to the account's library. Use this for a product, prop, toy or figure the user wants as a 3D asset, to spin in a viewer or to import into Blender; it is not for people or scenes. Pass image_asset_ids (the user's image assets in front, back, left, right order; trellis takes exactly one) or one https image_url, never both. model hunyuan3d-v3 is the quality default (about 21 credits, more with pbr or extra views); trellis is the 2-credit draft. texture defaults to true; pbr adds physically based materials on hunyuan3d-v3 only. A clean front photo of the object on a plain background works best. Spends credits and runs asynchronously (about one to three minutes): returns the QUEUED job, so poll nolgia_list_jobs until it reads succeeded, failed or canceled (canceled: its owner stopped it, nothing is delivered), then find the 3d asset with nolgia_list_assets (modality 3d); its signed_url is the .glb and thumbnail_url a preview image.

nolgia_generate_3d

One run creates 2 to 8 labelled Outputs sharing references and one visual system. Use kind pack for carousel slides or ad variants, or variants with axis for an emotion or concept ladder. Each member is its own image job with its own credit hold and refund. Poll with nolgia_get_set until Ready or Failed. For a catalog preset whose target kind is set, read its members from nolgia_get_preset, fill each labelled slot in every member prompt yourself, then call this tool.

nolgia_generate_set

Generate speech, music or a sound effect from a text prompt and save it to the account's library. Use this for voiceover, a soundtrack bed or an SFX cue; which one you get is decided by the model you pick, so check nolgia_list_models first. Spends credits. Returns the finished audio asset with a signed URL and credits_charged (what this generation cost, from the account's ledger; absent when it could not be read).

nolgia_text_to_audio

Generate an image from a text prompt PLUS one or more reference images: restyle a photo, edit part of it with a mask, or keep a subject consistent. Use this whenever the user supplies a picture to work from; for a saved NOLGIA character, fetch its reference URLs with nolgia_get_character and pass them here. Reference inputs are model-gated: gpt-image models and seedream-v5-pro take image_url plus image_urls, the other reference-capable models take a single image_url (see image.reference_images_max on nolgia_list_models). Spends credits. Returns the finished image asset with a signed URL and credits_charged (what this generation cost, from the account's ledger; absent when it could not be read).

nolgia_image_to_image

Generate a new image from a text prompt and save it to the account's library. Use this when the user wants a picture made from words alone; use nolgia_image_to_image instead whenever they supply a picture to work from, and nolgia_run_preset when they name a preset. Spends credits. Returns the finished image asset with a signed URL, plus the request id, the seed used and credits_charged (what this generation cost, from the account's ledger; absent when it could not be read).

nolgia_text_to_image

Submit a video generation job from a text prompt, or from reference videos when video_asset_ids / video_urls are set. Use this when nothing pins the opening frame; use nolgia_image_to_video when the user supplies the first image. Every reference, quality and duration parameter is gated by the model's `references` block from nolgia_list_models and rejected with a 400 elsewhere. Spends credits and runs asynchronously: returns the QUEUED job with credits_charged (the credits taken at submit, from the account's ledger; a failed or canceled render is refunded), so poll nolgia_list_jobs until it reads succeeded, failed or canceled (canceled: its owner stopped it, and status_message says what was refunded).

nolgia_text_to_video

Get the full canvas including graph and version. Read before editing; pass the version you last read to nolgia_update_canvas. A canvas is a node graph production plan for one project, built by the web editor and the NOLGIA Agent. Building a canvas does NOT run anything or spend credits. The customer runs it from the canvas in the web app, where each run shows its credit quote first and calls the ordinary generate endpoints. Use the generate tools directly when the person just wants one result now.

nolgia_get_canvas

Read a set and its ordered Outputs, image jobs, and available assets. Poll this tool while the set is Generating.

nolgia_get_set

Read a saved asset transcript as JSON, SRT or WebVTT. Free and read-only. Subtitle formats return an object with format and content fields.

nolgia_get_transcript

Get this account's generation counts, split into images, videos and audio. Use this when the user asks how much they have made. It reports counts, not a credit balance or an invoice. Read-only.

nolgia_get_usage

Fetch one character with freshly signed URLs for its reference images. Use this right before generating: pass those URLs as image_url / image_urls to nolgia_image_to_image, or as the start frame for nolgia_image_to_video, to keep the subject consistent. Returns the character, its ordered reference assets and identity verdicts; readiness is ready when the main reference shows one face front-on. Read-only. The face identity check (identity_score on renders) runs only once the user has confirmed consent for the character's photos in the NOLGIA app or CLI; you cannot give that consent, so when face_check.needs_consent is true tell the user to confirm it on the Characters page. Without it the photos are still used as references.

nolgia_get_character

Fetch one preset in full: what it makes and who it is for, the long description and use cases, worked EXAMPLES with playable image and video URLs you can show the user, its directions (children) or the family it belongs to, and the guided questions it asks, with the credit cost of one run. A SLUG IS ALL THIS NEEDS: when you already have the exact slug from a prior catalog result, a card the person tapped, or a slug they supplied, call this DIRECTLY without calling nolgia_list_presets again. If you only know the display name, resolve its slug from a prior catalog result or call nolgia_list_presets if none is available. Never guess a slug from a display name. Use the catalog also when the person has not chosen a preset. Returns the preset, its examples and its intake steps with each step's allowed answers. Read-only and free. WHEN YOUR HOST DISPLAYS THIS SERVER'S CARDS (ChatGPT does; a plain text client does not), the person can already see the result, and for a guided preset the card ASKS THE QUESTIONS ITSELF: it renders the examples, the directions and a form with a field, chips or a picker over their own library for every step, and a button that sends the answers. In that case, do not ask those same questions in prose. Point at the card, say what it needs in a sentence, and let them fill it in. Ask in the conversation only when the card says to, which is when a step needs something it cannot draw. In a text-only client, explain the preset in text and collect the required intake answers in conversation, using each step's allowed answers, before calling nolgia_run_preset.

nolgia_get_preset

Fetch one project by id, including its current asset count. Use this to confirm a project exists before passing its id as project_id on a generation. Read-only.

nolgia_get_project

Get the signed-in account's id and email, and its credit balance. Use this to confirm which NOLGIA account this credential belongs to before acting on the user's behalf, and to answer "how many credits do I have" or estimate whether a generation is affordable: `credits.available` is what this credential can spend and `credits.channel` names its pool rule (`app`: subscription credits first, then top-up credits, which is how the app, the NOLGIA Agent, organization keys and connected assistants such as ChatGPT or Claude spend; `api`: top-up credits only, a personal access token the user created). `credits.available_for_app` and `credits.available_for_api` are the two channel figures. `credits.total` is the billing-page balance. When `credits.scope` is `organization`, these are shared organization balances, further limited by `member_budget` minus `member_spent_this_month` when a budget is present (zero means no remaining budget). A balance is not a guarantee that generation will be authorized. `credits` is absent, rather than zero, when the balance could not be read. Read-only and free.

nolgia_get_account

List canvas summaries, including version and node_count, optionally filtered by project_id. A canvas is a node graph production plan for one project, built by the web editor and the NOLGIA Agent. Building a canvas does NOT run anything or spend credits. The customer runs it from the canvas in the web app, where each run shows its credit quote first and calls the ordinary generate endpoints. Use the generate tools directly when the person just wants one result now.

nolgia_list_canvases

List the built-in color-grade presets (LUT looks) a Studio composition can apply. Use this before writing a colorGrade on a composition element or canvas, so the `preset` slug you set is one that actually exists. For camera log footage (flat and grey, e.g. Sony S-Log3) also set the grade's `log` field to the clip's encoding (slog3, logc3, vlog or bmdfilm5): the clip is converted to Rec.709 first, then the adjustments and the preset apply. Returns the catalog version and each preset's slug, name and description. Read-only.

nolgia_list_color_presets

List the images, videos and audio this account has generated or uploaded, newest first. Use this to find work the user made earlier, narrowing by search, modality, tag or project_id rather than regenerating something they already have. `search` matches the name, the prompt or the model, `tag` is exact, and both filter the WHOLE library rather than the page in hand. Returns a page of assets with freshly signed URLs and a next_cursor to continue. Read-only. THIS TOOL ALONE ANSWERS a question about the person's library. Do not follow it with nolgia_list_projects or nolgia_list_characters to check whether there is more. On a host that draws cards, call it once and STOP. In a text-only client, follow next_cursor with subsequent calls to this tool when more matching assets are needed to answer the request; stop when next_cursor is absent or the request is satisfied. A library question is about their FILES; those other tools answer different questions, how work is grouped and which faces are saved, that nobody asked. WHEN YOUR HOST DISPLAYS THIS SERVER'S CARDS (ChatGPT does; a plain text client does not), the result renders as a GRID of the person's own media: the thumbnail, the name they gave it and its tags, filterable by images, video and audio, and tapping one asks to use that asset. They recognise their own work by looking at it, so do not read the list back as names and ids. Say what is there in a sentence and let them point. In a text-only client, where nothing is drawn, describe the assets in text, because an id alone is not something a person can act on.

nolgia_list_assets

List asynchronous generation jobs newest first, optionally filtered by status or modality. Use this to poll a video job submitted by nolgia_text_to_video, nolgia_image_to_video or nolgia_run_preset until it reads succeeded, failed or canceled, then fetch a succeeded job's result with nolgia_list_assets. Canceled means its owner stopped it: nothing is delivered, and status_message says what was refunded. Returns a page of jobs with status and a next_cursor. Read-only.

nolgia_list_jobs

List measured, narrow image tweaks with their allowed models and route. Includes known-unavailable scopes and their measured reasons; do not offer unavailable scopes. Use scope and detail on nolgia_edit_session_step when the customer wants one local change. Read-only and free.

nolgia_list_tweak_scopes

List every model this account can generate with. Use this BEFORE choosing a model or passing any reference, quality, duration or aspect-ratio parameter: the catalog is the source of truth for both capabilities and pricing, and the generate tools reject anything outside the selected model's capabilities with a 400. Returns each model's catalog `id` (what a generate tool sends), modality, plan floor (`min_tier`), credit cost and its billing unit, per-quality-tier costs, aspect ratios, durations, and a `references` block naming the reference inputs it accepts (start_frame, end_frame, video_refs_max, element_refs_max, audio_refs_max, bitrate_modes). Read-only and free.

nolgia_list_models

List the NOLGIA preset catalog: outcome-named recipes ("Logo design", "Product photo", "Explainer video") that already know the prompt, the model and the questions to ask. Use this to offer the user a proven starting point instead of assembling a prompt from scratch, then read one with nolgia_get_preset and run it with nolgia_run_preset. Returns each preset's slug, name, description, what it is best for, output type, thumbnail, rough time and credit estimate, whether it asks guided questions, and its family shape: a parent lists its directions, a direction names its parent. Read-only and free. CALL THIS ONCE. It takes no arguments and returns the ENTIRE catalog in one response: there is no pagination, no filter and no second page, so calling it again returns byte-identical data and, on hosts that display it, renders a second, duplicate gallery to the person. WHEN YOUR HOST DISPLAYS THIS SERVER'S CARDS (ChatGPT does, and any MCP Apps host; a plain text client does not), the person can already see a scrollable gallery of cards with artwork, each preset's own description, its credit range and its direction count, and they can filter it and open any card themselves. In that case, do NOT transcribe the catalog into your reply: listing the names in prose duplicates what is on their screen and buries it. Say what the catalog covers in a sentence, name at most three that fit what they asked for, and ask which one they want. In a text-only client, where nothing is drawn, use the returned catalog to answer in text, including the full list when requested; the three-suggestion limit does not apply. Reuse the same result rather than calling again.

nolgia_list_presets

List the account's projects: named groups of assets, where one asset may sit in several. Use this to see how the user already organizes work by client, campaign or scene before filing anything new. Returns each project with its current asset count. Read-only.

nolgia_list_projects

List the account's saved characters: reusable named subjects (a person, a mascot, a creature) carrying up to 8 reference images each. Use this first whenever the user names a recurring subject, so the next generation matches the last one instead of inventing a new face. Returns each character with its reference assets. Read-only.

nolgia_list_characters

List the account's saved styles: reusable looks, each a name, a prompt fragment and up to four reference images, with an optional model hint. Use this before generating when the user mentions their usual look, house style or a style they saved, then pass the style's id as style_id on nolgia_text_to_image, nolgia_image_to_image or nolgia_edit_session_step. Read-only and free.

nolgia_list_styles

Encore makes a finished, styled edit from the person's own files and words, in one of the Encore styles (a product drop, a travel film, a music video, a talking clip with captions, an edit remade with them in it, and more), on NOLGIA's servers: it keeps going after the chat moves on and lands in their library and in Studio. This lists the styles open to the person, each with its poster, a preview, its modes and what each mode needs (photos, clips, a song, a character, words). It takes no arguments. Free and read-only. Where the host shows this server's cards, the styles are on a card the person picks from, so do not read them back. For one style's whole form, call nolgia_encore_style with its slug.

nolgia_encore_catalog

This starts a new Encore run that makes the named shots of a finished run again, and spends credits: it is priced again first and starts only at exactly agreed_credits, the price nolgia_encore_redo_quote showed and the person accepted. Nothing starts when the request has a problem, when the balance does not cover it and its retake reserve, or when the price moved. Call it with the same run_id, items and vibe_marks as the quote, consent true only once the person has confirmed the consent statement for any images they add, and agreed_credits. The finished run and the person's files are kept as they are; the new run makes new files. Returns the new run's card; nolgia_encore_status checks its progress.

nolgia_encore_redo_start

Encore makes a finished, styled edit from the person's own files and words, in one of the Encore styles (a product drop, a travel film, a music video, a talking clip with captions, an edit remade with them in it, and more), on NOLGIA's servers: it keeps going after the chat moves on and lands in their library and in Studio. This reads one style's whole form: its file slots with their rules, its words with their limits, its options, and the consent statement every run confirms. Nothing is priced or started. Free and read-only. Where the host shows this server's cards, the form is on a card the person fills in, so do not read it back. Files must be in the person's NOLGIA library: pick them with nolgia_list_assets, save files attached in this chat with nolgia_add_chat_files, or ask them to upload at nolgia.ai. Then price the form with nolgia_encore_quote; for the flagship's scan mode, scan the edit with nolgia_encore_scan_edit instead.

nolgia_encore_style

Open one saved asset by id in its media card with inline video/audio playback or an image preview and a download action. Use this to show a completed generation or an existing library item; find the id with nolgia_list_assets first if needed. Returns metadata and a fresh signed media URL. Omit disposition for playback; use disposition=attachment only for a file download. In widget-capable hosts, prefer the card's playback and download controls. Do not alter or add query parameters to signed URLs: that invalidates the signature. Read-only.

nolgia_get_asset

Multicam turns one locked-off take (a video in the person's library, up to 2 minutes, shot from one fixed camera) into every chosen camera angle, each a full-length clip in sync over the take's own sound, plus a free highlight edit cut between the angles, a Studio timeline with every angle stacked, and a ZIP of every clip. This plans one: it reads the take, lists the angles it can have (grouped by how close, where the camera is and how it moves; on a take with no clear person the angles that need one are hidden and some are marked experimental), the ready-made packs, the highlight edit's cut list and the exact credit price with the person's balance. Free and read-only: nothing is rendered or charged. Pass pack, angles or custom_angles to price a choice; with none, the Auto pack is priced as a suggestion. Where the host shows this server's cards, the plan is a picker the person chooses from, so do not read the angle list back. Start the job with nolgia_multicam_start with the same choice, only once the person agrees to the price.

nolgia_multicam_plan

List the models that can run a Miroge mode on the customer's clip, each with the exact credits it would charge for this clip, which one is the default, and what it takes (how many photos, which clip lengths, whether the remake keeps the clip's length). Use it when the customer wants to compare prices or models before remaking. Free: nothing is generated or charged. Pass the same photos, characters and product you will remake with so the prices match; a model marked available: false says why in reason. Miroge remakes a video the customer already has, in one of three modes: motion (Motion transfer: the clip's moves, timing and camera performed by the customer's photos, characters or product), swap (Swap: replace one person, animal, product or outfit and keep the rest of the shot as filmed; with remove, take one thing out instead) or world (New world: keep the subject and its moves, redraw the place and the light around it).

nolgia_miroge_options