LexiSuite Docs

Panel media generation

Generate images and video, synthesize speech, transcribe recordings, and produce music or sound effects with locally installed, currently registered media executors. The Engine must be running and must report both the model and its requested task. A model file alone is not an execution capability.

Open Panel Instances to create and start a media instance, then Panel Builds and Engines to configure its engine. Open the Images, Video, Speech, Transcribe, or Audio links on the native media pages. Media guided tasks opens /rust/media. The classic controls remain usable on an instance configured for an external image or audio executor.

Guided task: Generate an image with a local model

  1. Open /rust/media/guides/image as an administrator. Confirm the Running instance ID is the intended live instance and choose a Bound model ID from the live inventory.
  2. Enter Image description and optional Width, Height, Steps, and Seed (optional) for this one request. The guide sends TextToImage to the native submission route; the interface refuses a model without a registered image executor.
  3. Choose Submit guided job. A queued receipt includes the job ID; queued does not mean that an image exists.
  4. Use Refresh job status to observe authoritative progress, or Cancel this job (undo) for a queued or running job. Tick Confirm job cancellation before selecting Request cancellation. The page rejects cancellation without this check. Cancellation requests do not certify immediate termination.
  5. Choose Open output gallery and receipts, then inspect the image, inference receipt, and model-license notice in Images. A completed engine job only becomes a retained output after the artifact has passed the Panel's checks.

This guide is also registered as media.image-local. Its checks include the live model inventory and the returned task identity. Its undo calls the registered cancellation route using the recorded job ID. The native Images form is also available directly at /rust/lexi-engine/images with Model, Task, Prompt / speech text, and task-specific settings.

Guided task: Transcribe audio and speak a reply

  1. Open /rust/media/guides/speech as an administrator. Identify the live instance and a transcription-capable model.
  2. Put a regular WAV file into that instance's media-inputs directory; enter its absolute path as Input WAV absolute path. Choose Submit guided job with the Transcribe task.
  3. Choose Refresh job status, then inspect the retained transcript on the native Transcribe page. Review its content before composing a reply.
  4. In Speak a reviewed reply, enter Running instance ID, Bound speech model ID, and Reply text. Optionally set Voice ID (optional) and Language (optional); select Submit spoken reply.
  5. Refresh the speech job and choose Open spoken reply gallery to play the resulting WAV. Cancel a pending job through Cancel this job (undo) after ticking Confirm job cancellation when necessary.

This guide is also registered as media.transcribe-and-reply. A transcription result is not silently turned into spoken text: the operator reviews the transcript and explicitly supplies the reply. Both steps require independent live model-task support.

Work directly on the five native pages

Page Tasks offered when reported by the running model Per-job inputs
Images (/rust/lexi-engine/images) TextToImage, ImageToImage, Inpaint, ImageEdit Prompt, negative prompt, width, height, steps, seed, guidance, sampler, scheduler, input image, PNG mask, edit strength
Video (/rust/lexi-engine/video) TextToVideo, ImageToVideo Image settings plus frames, FPS and video output container
Speech (/rust/lexi-engine/speech) Speak, ConvertVoice Prompt or speech text, input WAV when required, voice and language
Transcribe (/rust/lexi-engine/transcribe) Transcribe, Translate, Diarize Input WAV, language and optional text fields
Audio (/rust/lexi-engine/audio) Separate, Enhance, Vad, TextToMusic, TextToSfx Input WAV or prompt, voice and language as applicable

Every form is bound to an explicit local instance. Model and Task are selected only from live capabilities; an unavailable executor is never substituted with a different one. Files used as image, mask, or audio inputs must have approved types and absolute paths within the selected instance's media-inputs directory. Audio inputs are WAV, inpainting masks are PNG. An empty image or audio library does not imply that conversion is available.

For image or video jobs, Width (64-4096) and Height (64-4096) are subject to stricter executor limits, Steps (1-250) selects iterations, Seed (blank for random) gives reproducibility, and Guidance supports values from zero to 100. Edit strength (0-1) is for image editing. Video also has Frames (1-512), FPS (1-120) and Video output (y4m or apng). The native video path refuses durations over 120 seconds, frame dimensions above 2048 or not divisible by 32, and outputs exceeding its 32 MiB retention allowance. Recorded still images and audio also have file-size limits.

The Model license and Engine inference receipt (not qualification) appear beside retained jobs. Unreported commercial rights are not permission to use weights commercially. Refresh the page for progress; Cancel job only requests cancellation and does not remove stored results. Use Lexify this workload (measured optimization) to inspect performance optimization separately from media generation.

Configure models and devices

Open /rust/lexi-engine and set Models directory (absolute path), Model IDs, separated by commas, Multimodal VRAM budget (MiB), Multimodal device IDs (comma-separated), and Precision (auto, f16, bf16, f32). These fields map to --multimodal-models, --multimodal-model, --multimodal-vram-budget-mib, --multimodal-devices, and --multimodal-precision respectively. The interface disables unsupported engine flags. Save multimodal settings changes the profile, not the running process: restart through the normal instance controls to apply. Use existing model directory imports only a previously configured model directory path; it does not move files or transfer usage rights.

The classic image generation and audio task panels use their existing instance-bound API paths, separate from the native media profile. Pick the intended engine and inspect its available tasks; a result from one executor must not be treated as another executor's output.

Routes used by the media screens and guides

Method and route Purpose
GET /api/ux/media/models Administrator-only live model inventory (inst query)
POST /api/ux/media/submit Administrator-only image, transcription or speech submission, with per-job settings
POST /api/ux/media/status Administrator-only authoritative refresh and retained-artifact metadata
POST /api/ux/media/cancel Administrator-only cancel request for a recorded, active job
POST /api/lexi/media/capabilities Native programmatic capability discovery
POST /api/lexi/media/submit Native programmatic media admission
POST /api/lexi/media/status Native programmatic job status
POST /api/lexi/media/result Native programmatic result retrieval
POST /api/lexi/media/cancel Native programmatic cancellation
POST /api/sd/generate Classic external image generation
POST /api/sd/cancel Classic external image cancellation
GET /api/sd/gallery Classic external image gallery
POST /api/ac/run Classic external audio execution
POST /api/ac/models Classic external audio model control
POST /api/ac/unload Classic external audio model unloading

The guided API accepts string form values for instance, model, task, prompt, input path and optional settings. A submission responds with id, task and status=queued only when the existing adapter records real engine admission. The status response includes status, progress, error, artifacts and the original receipt when available. Unknown job IDs and unsupported tasks are refused; unauthorized users cannot run privileged guide actions.

Control reference

Each help marker (?) shows the following exact registry tooltip. Classic-only controls receive their help through their classic screen selector.

Screen control Help text Native screen
Running instance ID (media.instance) Choose the local instance that owns the media models and input files for this job. /rust/media/guides/image
Generate (media.classic-image) Generate an image using the selected external image instance and its per-job settings. /rust/lexi-engine/images
Cancel (media.classic-image-cancel) Request cancellation of the selected external image job; inspect status again before assuming it stopped. /rust/lexi-engine/images
Image gallery (media.classic-image-gallery) Review the external image instance's recorded outputs and their status. /rust/lexi-engine/images
Run (media.classic-audio) Run a task using the external audio instance and its model-specific options. /rust/lexi-engine/audio
Model (media.classic-audio-models) Choose the external audio model that supports the requested task. /rust/lexi-engine/audio
Unload models (media.classic-audio-unload) Unload external audio models to release memory; a later job must load them again. /rust/lexi-engine/audio
Media guided tasks (media.home) Choose the media task and inspect the running instance before submitting a job. /rust/media
Images (media.images) Generate or edit images using a live registered executor. /rust/lexi-engine/images
Video (media.video) Generate video frames using a registered executor; retained files must fit the output limit. /rust/lexi-engine/video
Speech (media.speech) Convert text into speech or convert a voice using a registered executor. /rust/lexi-engine/speech
Transcribe (media.transcribe) Turn input WAV audio into text, translation, or diarized segments. /rust/lexi-engine/transcribe
Audio (media.audio) Run audio enhancement, separation, music, sound effects, or activity detection. /rust/lexi-engine/audio
Models directory (absolute path) (media.models-dir) Choose an absolute directory of locally installed media models; restart to apply. /rust/lexi-engine
Model IDs, separated by commas (media.selected-models) Select the registered media model IDs for this instance; restart to apply. /rust/lexi-engine
Multimodal VRAM budget (MiB) (media.vram-budget) Set the memory budget in MiB for this instance; engine admission checks available memory. /rust/lexi-engine
Multimodal device IDs (comma-separated) (media.devices) Choose device IDs for this instance; restart to apply the device selection. /rust/lexi-engine
Precision (auto, f16, bf16, f32) (media.precision) Choose automatic or an explicitly supported precision for this instance. /rust/lexi-engine
Save multimodal settings (media.save-profile) Save model and device settings; restart the instance to apply new launch arguments. /rust/lexi-engine
Use existing model directory (media.migrate) Reuse a compatible local model directory without moving or deleting source files. /rust/lexi-engine
Model (media.model) Select a model reported with the chosen task by the running instance. /rust/lexi-engine/images
Task (media.task) Choose a task supported by the selected model; unsupported tasks cannot be queued. /rust/lexi-engine/images
Prompt / speech text (media.prompt) Describe the image, music, sound, video, or spoken reply to produce. /rust/lexi-engine/images
Negative prompt (optional) (media.negative-prompt) Describe unwanted visual elements for tasks that support negative prompting. /rust/lexi-engine/images
Width (64-4096) (media.width) Set the output width from 64 to 4096 pixels, subject to the executor limits. /rust/lexi-engine/images
Height (64-4096) (media.height) Set the output height from 64 to 4096 pixels, subject to the executor limits. /rust/lexi-engine/images
Steps (1-250) (media.steps) Set generation iterations between 1 and 250, subject to model limits. /rust/lexi-engine/images
Seed (blank for random) (media.seed) Specify a repeatable nonnegative random seed or leave blank to choose one automatically. /rust/lexi-engine/images
Guidance (media.guidance) Set prompt guidance between zero and 100 when supported by the executor. /rust/lexi-engine/images
Sampler (optional) (media.sampler) Choose an executor-supported sampling algorithm; blank keeps the model default. /rust/lexi-engine/images
Scheduler (optional) (media.scheduler) Choose an executor-supported noise schedule; blank keeps the default. /rust/lexi-engine/images
Frames (1-512) (media.frames) Set video frame count between 1 and 512 within the retained output limit. /rust/lexi-engine/video
FPS (1-120) (media.fps) Set video frame rate between 1 and 120 frames per second. /rust/lexi-engine/video
Video output (media.video-container) Choose the supported video file format for the retained output. /rust/lexi-engine/video
Input image file (optional) (media.image-input) Provide an absolute path to a supported file in this instance media-inputs directory. /rust/lexi-engine/images
PNG mask file (for Inpaint) (media.mask-input) Provide a PNG mask in the instance input directory when inpainting. /rust/lexi-engine/images
Edit strength (0-1) (media.strength) Set image edit strength from zero to one when required by a task. /rust/lexi-engine/images
Input WAV file (when required) (media.audio-input) Provide an absolute WAV path in the instance media-inputs directory for audio tasks. /rust/lexi-engine/transcribe
Voice ID (media.voice) Select an available voice identifier for speech synthesis or conversion. /rust/lexi-engine/speech
Language (media.language) Request a supported language for speech or transcription; blank uses the executor default. /rust/lexi-engine/speech
Submit to Lexi Engine (media.submit) Queue the task with its per-job settings only after the engine confirms admission. /rust/lexi-engine/images
Confirm job cancellation (media.cancel-confirm) Confirm a queued or running job may stop before it produces a complete result. /rust/media/guides/image
Cancel job (media.cancel) Ask the engine to cancel a queued or active job; status must still be refreshed. /rust/lexi-engine/images
Refresh job progress and gallery (media.reload) Refresh authoritative engine job state and retained results. /rust/lexi-engine/images
Model license (media.license) Review the model license; an unspecified commercial-use right must be verified. /rust/lexi-engine/images
Engine inference receipt (not qualification) (media.receipt) Inspect the engine-provided request receipt; a queued job is not an output. /rust/lexi-engine/images
Output gallery (media.artifacts) Review or download retained artifacts only after the job succeeds. /rust/lexi-engine/images
Lexify this workload (measured optimization) (media.optimization) Open measured optimization for this model without modifying the current job. /rust/lexi-engine/images
Guided task: Generate an image (media.guide-image) Walk through live model checking, submission, status, outputs, and cancellation. /rust/media/guides/image
Guided task: Transcribe and speak a reply (media.guide-speech) Walk through audio input, transcript review, and speech generation. /rust/media/guides/speech

See Panel Models for model file management, Panel Instances for starting and restarting instances, and Panel Diagnostics for execution failures. All media results depend on the running executor and the actual model's license and resource requirements.