Skip to Content
Starlight

Generations

Make AI images, videos and upscales from inside Starlight, and keep them with the project.

A generation is one AI job. You write a prompt (a description), pick a model (the AI that makes it), and a provider runs the job. A provider is an online AI service: Magnific or videorouter.sh. An upscale makes an image or a video bigger and sharper.

Open the Generations panel toggle ⇧G / Shift+G

The Generations panel lists every generation job of this project.

  1. Press ⇧G / Shift+G, or choose Window › Generations.
  2. Read the list. The newest job is at the top. A running job shows its progress.
  3. To filter the list, click active, done, failed or all. Each button shows how many jobs it holds. failed also holds cancelled jobs.
  4. To filter more, use the provider and kind menus in the toolbar.
  5. Video version and pre-render jobs are in the same list (Video versions, Pre-render a node). To see only them, click versions.
  6. To sort by grade (your mark for a result, see Grade results), click newest. It changes to best first. The order is circled down to NG, then ref, then the jobs with no grade.
  7. To change the view, click the view button in the panel's title row. It shows lines (the compact view: one line per job) or two boxes (the detail view: cards). Click it to switch. The compact view is the default.
  8. Click $ in the panel's title row to see what's left on each service. It sits between 🔍 and the view button. Each row shows a service, the money left, and when Starlight read it. Click the round arrows to read again.
    • no balance from its API: the service does not tell Starlight its balance. Click open account page to see it on the service's website.
    • no key — Settings › Keys: add a key first. Click it to open Settings › Keys.
  • With no jobs yet, the panel says no generations yet. It shows one line per provider and a + new generation button. If a key is missing, it also shows set up keys.
  • If the filters hide every job, the list says nothing here. Click show all to clear the filters.
  • The header shows what the project has spent, per provider. It also counts the jobs per grade. Click a count to show only those jobs (Check the price).
  • The search stays while you work. Press Esc in the field, or click ×, to clear it. While a search is set, the 🔍 stays lit. If no job matches, the list says nothing matches “…”.
  • A line at the bottom of the panel says what happened, for example imported → assets/hero.mp4. It stays in view while you scroll. A message that says something failed, or was refused, stays until you click its ×. Other messages go away after a few seconds.
  • The refresh button (two arrows, at the right of the toolbar) is sync. It checks every unfinished job now. The button stays grey until the check is done. It answers, for example, synced · 2 updated. If a provider no longer has a job, the answer names it, for example lost at provider: “hero still” (g1…) (see lost at provider). Gen › Sync Generations in the menu bar does the same, also while the panel is closed. So does sync generations in the command palette.
  • Each ⌘K compose request is one line, with its jobs under it.
  • If you quit Starlight, a running job continues at the provider. Starlight picks it up again when you open the project.
  • The view you pick is remembered for each project.
  • In a shared project you see only your own jobs. Import a result to share it (Share a project).
  • Claude can also price and run generations. The MCP cap is the most that one job started by Claude may cost (Permissions and spending).

Read the job list

Each job in the list shows what it is, how far it got, and what it cost.

The compact view shows one line per job. From left to right:

PartWhat it shows
Coloured left edgeThe grade. No colour means no grade yet.
Small pictureThe result.
Kindimage, upscale, video or v-upscale.
NameThe label (or the prompt), then the model.
⚠ 2The job has warnings: things to check. The number says how many. Notes (ⓘ) are not counted here (Warnings and notes).
StatusFor example done $2.77 → assets, running 45%, tiles 2/4 or needs a key. A failed job also says why, in short: for example error · site blocks this connection.

Hover a line to read the full prompt, the provider, the grade, any errors, the warnings (⚠) and the notes (ⓘ). A job graded NG is dimmed.

The detail view shows one card per job.

PartWhat it shows
PictureThe result. Click it to preview.
Title and chipThe label or prompt, and the status. While the job runs, the chip shows a percentage.
Second lineprovider · model · kind, the surface it is for (→ N), and the grade.
FactsHow long it ran, the cost (est. means an estimate), the size and length, and the number of files. ✓ in assets means it is imported.
Buttonscancel while it runs. retry after a failure or a cancel. import when it is done. ⋯ opens the job menu (Use a result).
Red, yellow and grey linesErrors (red), then warnings (yellow), then notes (grey, with ⓘ).
StatusIt means
awaitingMade, but not sent yet. waiting for a key — add one in Settings › Keys means its provider has no key.
queuedThe provider has the job and will start it.
runningThe provider is making it.
doneThe result is downloaded to this computer.
rejectedThe provider refused it, for example for its content. Starlight does not try again by itself.
errorSomething broke, at the provider or in Starlight. You can retry it. The line shows a short reason after error. Hover the line, or look at the card, for the whole message. site blocks this connection: see Blocked connection.
lost at providerThe provider no longer has the job. It may have expired, or it was made with another key. The result is not on this computer. Click retry to make it again. Starlight never retries it by itself, because a retry costs money. (When the result is already on this computer, the job stays done. Its details then have a note: the provider no longer keeps this job; the result is safe on this machine.)
cancelledYou cancelled it.

Warnings (⚠) and notes (ⓘ). A job, and its quote, can have two kinds of message.

  • A warning (⚠) is something to check. The job may fail or be refused. Or it may cost more than the estimate. Or the result may come back worse than you asked, or at another size. For example: returned 1280×720, expected 1920×1080. The line counts the warnings (⚠ 2).
  • A note (ⓘ) is only information. You do not need to do anything. For example: price from the published rate. Notes are grey, in the job's details: hover the line, or open the card. They are not counted on the line.
  • Jobs made together (the tiles of one surface, or one click on generate N) often share a warning. The line shows it once for the group, not on every line. Each job's details still show all of its own messages.
  • Jobs made with an older Starlight had only warnings. Starlight now shows their notes as notes.

Make an image or video

The new-generation form sends one job to a provider.

  1. Click + new in the panel. You can also press n in the panel, choose Gen › New Generation…, or pick new generation… in the command palette.
  2. Type the prompt. For an image, describe the image. For a video, describe the shot: motion, camera and light.
  3. If the model has inputs (a start frame, an end frame, a reference or a source), click + add. Pick one of your assets, or the result of another generation. You can also drag one onto the slot (see Drop an input on a slot).
  4. Click model. Pick the provider, then the model.
  5. Click settings to change the model's own options, for example its size or its length.
  6. Under output, type a label.
  7. In for surface, pick the surface (one LED output) the result is for. The form sets the model's shape to match that surface, and shows what it will send (see Match a surface's shape).
  8. Read the price beside the button (see Check the price).
  9. Click generate, or press ⌘⏎ / Ctrl+Enter.

Save it for later (pending). Click save beside generate to keep the form without running it. Nothing is sent and nothing is spent.

  • The form stays open. The next save updates the same pending generation.
  • Back in the list, pending at the top lists every one saved in this project, newest first. Each row shows the label or the first line of the prompt, then the model, who saved it and when.
  • Click a row to open it in the form, exactly as it was saved: the prompt as you typed it, the inputs and every setting. Change it, save it again, or generate.
  • When you generate it, it leaves the pending list. The job keeps its prompt, so duplicate on the job opens it again.
  • Click × on a row to remove it. Starlight asks first.
  • Everyone on the project sees the pending list. In a project in Dropbox, another artist's save shows up when it syncs. A save by someone else replaces yours if you both change the same one.
  • Only what you save is kept. Closing the form without save keeps nothing.
  • The search above the list also searches the pending list.

The prompt. The box says (optional) when the model can run without one. Some models take no prompt at all. The form then says … takes no prompt — pick its input below.

The inputs. Each input slot has a name, for example Start frame or Reference images.

  • optional beside the name means the job can run without it. A number such as 1/9 shows how many you added, and the most it takes.
  • The button reads + add, or change when a one-item slot is full. While the picker is open it reads done.
  • The picker has two groups: assets and generations (finished results). Only files of the right kind are listed.
  • Click × on an input to remove it.
  • If nothing fits, the picker says no image in this project yet — import one in assets, or finish a generation.
  • The End frame slot shows only for a model that takes an end frame. The video then ends on that picture. To make a loop, use the start frame again.

Drop an input on a slot. Each input slot is also a drop zone. The slot lights up while you drag something over it.

  • Drag an asset from the Assets panel onto the slot.
  • Drag a finished job from the Generations list onto the slot.
  • Drag an image or video file from Finder or Windows Explorer onto the slot. Starlight first imports it into the project's assets, as a drop on the canvas does. Then the slot uses it.
  • If the slot cannot take that kind of file, a line under the slot says so. For example: Start frame takes image — not a video.
  • A click on the slot's row still opens the picker.

The model picker. Your Favorites are at the top. Then the models are in groups: image, upscale, video and video upscale. Type to search by name, by maker or by kind, for example flux, edit or upscale.

  • Each model has a star at the right. Click ☆ to add the model to your Favorites. It turns to ★. Click ★ to remove it.
  • The Favorites are saved for you, on this computer, and stay after a restart.
  • At first, the Favorites are GPT Image 2, Seedance 2.5 Pro, Kling 3.0 Pro, Seedream 5.0 Pro, Nano Banana Pro and Flux 2 Pro.
  • A favorite that Starlight cannot run yet stays in the list, in grey.
  • In the picker, use ↑ ↓ to move and ⏎ / Enter to pick. Esc closes it.
  • The line under the active model gives its description and its price. A grey model says not yet wired: it is listed, but Starlight cannot run it yet.
  • The model section folds to one line: provider · model. It opens by itself when the model cannot run.
  • The form opens on the last model you generated with. The first time, it opens on the default image model: GPT Image 2 (OpenAI's ChatGPT Images 2.0, on Magnific).
  • The default video model is Seedance 2.5 Pro. It is used on Magnific when Magnific has a key, else on VideoRouter. use as start frame opens on it, and so does a switch to VideoRouter.
  • A duplicated job keeps its own model.
  • The dot beside a provider is lit when its key is set (Providers and keys).
  • When you change model, the prompt, the label, the surface and the matching inputs stay. Settings you changed stay when the new model has them.
  • All the models and what they need: Models and their inputs.

More options.

  • Some models also take a negative prompt: what to leave out. Click + negative prompt.
  • The settings section also folds to one line. That line shows the main values, for example Duration (s) 8 · 21:9.
  • On an image or upscale model, turn on transparent (remove background after) to add a paid Remove Background step. It is a second Magnific job. Its transparent PNG goes into your assets automatically.
  • transparent is hidden while tile to surface size is on (Upscale a result).
  • The label names the job in the list, and the file when you import it. for surface can stay any.
  • When the surface is wider than 4096 px, the size line adds wider than one output — upscale, then tile.

Static camera. For video, the box static camera — no camera moves is under the prompt. It is on by default. The camera then does not pan, push, zoom or orbit. Use it for LED plates, and always for tiles that are put back together: tiles that move the camera do not match at the seams.

  • The box always adds this sentence to the prompt: Static locked-off shot on a tripod. The camera does not move for the whole clip. No pan, no tilt, no zoom. It is added once.
  • If the model has a camera setting, the box sets it too. For example, Seedance 2.0 turns on Lock camera, and Seedance 2.5 Pro sets Camera motion to static. Hover the box to see what it sets. The form hides those settings from settings.
  • Why both? A camera setting is not a promise. The model reads it as more prompt text. The sentence makes it clearer.
  • Untick the box when you want a camera move.

Match a surface's shape. Pick a surface in for surface. The form then sets the model's shape setting (for example Aspect ratio) to the surface's shape. You do not need to set it by hand.

  • A line under the picker shows what the form will send, before you pay. For example: E1 3200×1600 (2:1) → Magnific One 2:1, ≈2048×1024.
  • The size is the model's size for that shape. ≈ means about: the model decides the exact pixels.
  • If the model has the surface's shape, the form uses it.
  • If the model does not have it, the form uses the nearest shape. The nearest shape is the one that loses the least of the image. When two shapes are about as near, the form uses the wider one.
  • When the shape is not exact, the form says so. For example: Magnific One has no 4:1 — nearest is 3:1, the image will be cropped to fit N. Cropped means that the edges are cut off so that the image fills the surface.
  • If a model makes square images only, the form says so: … makes square images only.
  • An upscaler keeps the shape of its source image. A video with a start frame keeps the shape of the frame. Crop the frame to the surface's shape first.
  • When a start frame sets the clip's shape, the form turns off Aspect ratio and shows shape follows the start frame. There is nothing to choose: the clip has the frame's shape.
  • When you change the model, the form sets the new model's shape for the surface again.
  • You can still change the shape in settings. If it does not fit the surface, a yellow line says … the image will not fill E1. Click match E1 to set the surface's shape again.
  • A duplicated job keeps its own shape. If that shape does not fit its surface, you see the same yellow line and the match button.
  • Starlight never falls back to a square without saying so.
  • Generations that MCP or ⌘K compose make for a surface also get the surface's shape when they do not set one.

All surfaces at once. In for surface, pick all. One click on generate N then makes one job for each surface of the project.

  • Each job gets its own surface's shape.
  • Each job gets the label <label> · <surface>, for example aurora · E1.
  • The prompt, the seed and the settings are the same for all the jobs.
  • The price beside the button is the total for all the jobs, for example ≈ $10.20 · 5 jobs. The ⓘ shows the price of each job.
  • all is not offered for a tiled upscale. A tiled upscale has its own target.

Example shapes for the arena's surfaces with Magnific One: E1 (2:1) gets 2:1. S (3:1) gets 3:1. E2 (2.4:1) gets 21:9. N and W (4:1) get 3:1, because 3:1 is the widest shape that Magnific One makes.

Beside the button. One short line is beside generate. The other details are behind the ⓘ button.

  • The line shows the price, for example ≈ $2.04. It reads pricing… until the price comes back.
  • If something stops the job, the line says what it is, in yellow. Then generate stays off until you fix it.
  • no Magnific key — add one means the provider has no key. Click add one to open Settings › Keys.
  • needs: … lists what is missing, for example a prompt is required.
  • Click ⓘ to open the details: the full quote line (model, host, size, length, shape and price), notes and warnings. Click it again to close them. The details are closed at first. Starlight remembers if you leave them open.
  • The ⓘ turns yellow when the quote has a warning.
  • While it sends, the button reads submitting…. For a tiled upscale it reads generate N tiles.
  • cancel, Esc or ← jobs closes the form. If an input picker is open, Esc closes the picker first.

Models and their inputs

This table lists the models that Starlight can run, and what each one needs.

In the form, hold the pointer over a setting, an input or the model to read what it does.

ModelMakesNeeds
MysticimageA prompt (optional). Structure reference and Style reference, one each (optional).
Magnific OneimageA prompt. Up to 10 Reference images (optional).
Nano Banana Pro, Pro Flash, 2.1imageA prompt. Up to 14 Reference images (optional).
Seedream, GPT Image, Flux, Ideogram, Recraft, Runway, Gemini and moreimageA prompt. The Edit models also need the Images to edit.
Image Expand (Flux Pro, Ideogram, Seedream 4.5)imageThe Image to expand. See the note below.
Remove BackgroundimageOne JPG or PNG image, 20 MB at most. It returns a transparent PNG.
Magnific Creative upscalerupscaleThe Image to upscale. A prompt (optional).
Magnific Precision V2, Precision (v1)upscaleThe Image to upscale. No prompt.
Seedance 2.5 Pro, 2.0 Pro, 2.0 Fast, 2.0 Mini (Magnific)videoA prompt. A Start frame, an End frame, References and Reference audio are optional.
Kling, Veo 3.1, MiniMax, Wan, LTX, PixVerse, Runway (Magnific)videoA prompt in most cases. Most also take a Start frame, and some an End frame.
Magnific Video Upscaler, Turbo, Precision, Topaz Starlightvideo upscaleThe Video to upscale. No prompt.
Seedance 2.5 (VideoRouter)videoA prompt. A Start frame (and an End frame on fal, Replicate or OpenSand), or up to 9 Reference images. A Draft runs on Atlas Cloud only, so it takes no end frame.
Seedance 2.0 (VideoRouter)videoA prompt. A Start frame, or up to 9 Reference images.
Seedance 2.0 (Higgsfield)videoA prompt. A Start frame (and an End frame), or up to 9 Reference images. The prompt is optional with a frame or references. Up to 4K.
Seedance 2.5 (Higgsfield)videoA prompt. A Start frame (and an End frame), or References (up to 30 images and 10 MP4 videos) and Reference audio (up to 10 WAV files). The prompt is optional with a frame or references. Up to 1080p and 30 s.
Seedance 2.5 video edit (Higgsfield)videoA prompt and the Video to edit (MP4, 4–30 s). References and Reference audio are optional. The clip keeps the video's length and shape.
Seedance 2.5 (Atlas Cloud)videoA prompt. A Start frame (and an End frame), or up to 30 Reference images. The prompt is optional with a frame. Up to 1080p, 4–30 s. Draft (480p preview) works with a start and an end frame.
Seedance 2.5 video extend (Higgsfield)videoA prompt and the Video to extend (MP4). References and Reference audio are optional. The clip keeps the video's shape.
  • The picker also lists grey models that Starlight cannot run yet. Examples: Ideogram Image Edit and Runway Act Two on Magnific, Kling 3.0 and Veo 3.1 on VideoRouter.
  • Seedance video takes a start frame or references, not both. An end frame needs a start frame.
  • With a start frame, a Seedance video keeps the frame's own shape. Its Aspect ratio setting is then ignored.
  • Seedance and Kling refuse a start frame, end frame or reference image that is wider than 2.5:1 or taller than 1:2.5, or under 300 px on a side. Seedance also refuses one over 6000 px on a side. Generate stays off until you crop or resize it. For a wider surface, crop the frame to 21:9, or generate panels and join them.
  • Some services take pictures of 10 MB at most. VideoRouter is one, and so are some Magnific models such as Kling and Seedream. Atlas Cloud takes 30 MB at most. A bigger PNG or JPEG still works. Starlight sends a JPEG copy that fits, and your file stays as it is. The details of the job say so. The copy has the same size in pixels when it can. Transparent parts of a PNG become black in the copy.
  • Generate also stays off for a prompt longer than the model takes, and for a reference image the model can't read, such as a GIF.
  • An Image Expand model makes an image wider or taller. In Target size or ratio, type a size such as 6400x1600, or a ratio such as 4:1.
  • Source sits says where the original image stays, for example centre (grow both sides).
  • The price line says what size comes back. It is smaller than the target, so upscale it afterwards.
  • Seedance 2.5 on videorouter and on Atlas Cloud has Draft (480p preview): a cheap, quick version of the video. On Atlas Cloud a draft can have a start frame AND an end frame. On videorouter it cannot have an end frame. To try an idea cheaply:
    1. Turn on Draft (480p preview) and click generate. A draft costs the same as a 480p clip.
    2. When the draft is done, its job has a line that says if you can finish it, for example final from draft · 6 days left.
    3. When you like the take, click finish at 1080p on the job, or right-click the job and pick it. Starlight makes the same take again at 1080p, as a new job. It costs the same as a 1080p clip of the same length.
    4. The new job is scrolled into view and lights up for a moment. If it cannot start, or fails later, a message at the bottom of the panel says why. It stays until you click its ×.

    The line on a draft says one of these:

    The line saysWhat it means
    final from draft · 6 days leftYou can finish it. A draft can be finished for 7 days after it was made.
    final failed · 6 days leftThe last 1080p final failed. You can try it again.
    draft expired · older than 7 daysThe draft is too old. It is grey, and finish at 1080p is grey too. Make a new draft.
    final already madevideorouter only. videorouter finishes each draft once, and this one is done. Click show the final to go to the 1080p job.
    final in progressvideorouter only. The 1080p final is running now. Click show the final to go to it.

    Atlas Cloud can finish the same draft more than once. Its line then also has show the final.

  • On videorouter, Host picks who makes the video, or the cheapest host. Allow fallback hosts lets videorouter use another (often more expensive) host.
  • Upscale one tier on Seedance 2.5 works on the Atlas Cloud host only. With another host chosen and fallback hosts off, Generate stays off until you pick Atlas Cloud or turn it off.

Compose a change with Claude (/, ⌘K / Ctrl+K)

Describe a change in plain words in the command palette. Your words go to the Claude panel, and Claude edits the scene. You need no API key.

  1. To aim the change at one surface or layer, select it first.
  2. Press /, ⌘/ / Ctrl+/ or ⌘K / Ctrl+K. The palette opens at the top of the window.
  3. Type the change in plain words, for example "make a slow gold shimmer on N".
  4. The top row now says ask Claude: …, with your words. This row is selected. Its grey text names the Claude tab that gets your words, for example tab 2 · N surface looks.
  5. Press ⏎ / Enter. If the Claude panel is closed, it opens. If it has no tab, a tab starts.
  6. A line at the top of the window says what happens, for example sent to Claude · tab 2.
  7. Watch the canvas. Claude changes the scene, then looks at the result (Ask Claude for a change).

A command, or words for Claude? The palette decides which row comes first:

  • A few words that name a command come first as a command. Examples: lev, fit all, exp sc, open N, add text, new gen. The two ask Claude rows wait at the end of the list.
  • A sentence goes to Claude. Examples: "add a soft glow to the logo", "open the stage and set it to night", "can you export the scene". A sentence never runs a command, also when it starts with one.
  • A question (it ends with ?) goes to Claude.
  • Words that start with claude go to Claude. Starlight removes that first word before it sends them: "claude make it gold" sends "make it gold". It also removes claude:, claude,, ask claude, hey claude, @claude and /claude. A later "claude" in your words stays.
  • Is the wrong row first? Press ↑ ↓ to pick the other one, or use the keys below.

Choose where your words go.

  • ⌘⏎ / Ctrl+Enter always sends your words to the Claude tab in front, whatever row is selected.
  • ⇧⌘⏎ / Ctrl+Shift+Enter always opens a new Claude tab and sends your words there. Use it for a new subject, or when Claude is busy in the front tab. The row ask Claude in a new tab does the same.

The line at the top of the window says what happens to your words:

The lineWhat it means
sent to Claude · tab 2Your words went into that tab. Claude starts to work.
starting Claude…The Claude panel is opening, or a new tab is starting. Your words go in when Claude is ready.
Claude is busy. It sends when Claude finishes.Claude works on an earlier request. Your words wait, then go in.
your unsent words are in the prompt: send or clear them firstThe Claude prompt has text that you did not send. Your words never mix with it. Send or clear that text, then your words go in.
a question is open in Claude. Answer it, then it sends.Claude asks you something in its panel. Answer it.
Claude asks whether to trust this folder. Answer it in the Claude panel, then your message sends.A new Claude tab started in a folder that Claude Code does not know yet, so it asks if it can trust the folder. Open the Claude panel and answer the question. Starlight never answers it for you. Then your words go in.
the Claude panel is closed. It sends when you open itYou closed the panel while your words waited. Open it with ⌃` / Ctrl+`.
  • History: in an empty palette, press ↑ to get back the words you sent before. Press ↑ again for older words, and ↓ for newer words. Press ⏎ / Enter to send them again. The palette keeps your last 50 messages, on this computer.
  • Your words stay in the palette when you close it with Esc. They go away when you send them, or when you run a command.

What Claude gets. Starlight adds where you are: the scene, what is selected, and the playhead. For example:

Compose in scene 02-walls (selected: [surface N]; playhead [t=1.250s of 4.000s, frame 37 @30fps]): make the hero word gold

  • The selection uses the same words as a reference (Point Claude at what you mean).
  • Claude Code uses your own Claude sign-in. Starlight stores no key for it.
  • Claude does not start within 20 seconds? Or the Claude panel does not change for 20 seconds while the line says Claude is busy? Then Starlight stops waiting. The palette opens again with your words in it, and says what to do:
    1. Open the Claude panel with ⌃` / Ctrl+`.
    2. Look at it. Answer a question there, or wait until you see Claude's prompt.
    3. Press / or ⌘K / Ctrl+K, then ⏎ / Enter, to send your request again. Your words are still in the palette.
  • Several requests go in one at a time, in order.
  • Claude Code is not on this computer? The palette says so and keeps your words. The Claude panel shows the install command. Install Claude Code, then press ⏎ / Enter again (When Claude does not start).
  • To undo the change: Undo Claude's change.
  • To skip Claude, type /gen (or /generate) and a prompt in the palette. The top row then says open the generation form: …. Press ⏎ / Enter. The form opens with that prompt and the selected surface.
  • Esc closes the palette.

Who plans. Pick the planner in Settings › Generation › ⌘K planner:

  • claude code: the default. ask Claude sends your words to the Claude panel. No key is needed.
  • openrouter: a model on OpenRouter plans the change inside Starlight, without the Claude panel. Type the model id in model. It needs an OpenRouter key.

The first Claude row shows where your words go. On the Claude panel it says ask Claude: …. On openrouter, it says plan with OpenRouter: …, and the palette decides which row comes first in the same way. ask Claude in a new tab still sends your words to the Claude panel. On openrouter with no key, the palette says so and shows a Settings › Keys button. The commands still work.

With openrouter: the plan.

  1. Press ⏎ / Enter on plan with OpenRouter: …. The model writes a plan.
  2. If every generation in the plan costs $0 (or the plan has none), Starlight applies it at once. Press ⌘Z / Ctrl+Z to undo it.
  3. If a generation in the plan has a price, or has no price yet, the plan waits in the palette. Each step shows its price.
  4. Click approve · $… to run the plan, or cancel to drop it. Nothing runs or spends money before you click.
  • Each step of a waiting plan shows its kind, its label and its price. The line under the buttons says prices are estimates · nothing runs until you approve.
  • A plan has at most 8 generations. Planning stops after 30 seconds.
  • If the scene changed after the plan was made, approve is refused. The bar says the scene changed since this plan was made — run the prompt again (nothing was spent).
  • Starlight checks the prices again when you approve.

After approve. The scene changes at once. Placeholders (stand-ins: a grey image, or a short black video) show where the new media will go. Each generation replaces its placeholder when it arrives.

  • The bar closes and a status line follows the jobs. Click open to see them in the panel. If a job fails, click retry or dismiss.
  • ⌘Z / Ctrl+Z undoes the scene change.
  • Click undo on the compose line in the panel to also stop its running jobs and remove its placeholders. Starlight asks first. Finished generations stay in your assets.
  • details on a step opens the new-generation form, filled in from that step.

The compose line in the panel. Each openrouter request shows its prompt, a short summary, its steps and its total cost.

  • Its status is approve?, running, done, partial (a generation failed), failed, cancelled or undone.
  • A waiting request has approve and cancel here too. A running one has cancel. An applied one has undo.
  • A failed step has retry. Its result still lands at the same place.
  • In the compact view, click the line to open its card. A waiting request always shows its card.
Online only

⌘K needs the internet: Claude, and the models on OpenRouter, run online. A plan that fails never changes your scene.

Providers and keys

Each provider needs its own API key before it can run a job. An API key is a secret code from your account on the provider's website.

ProviderWhat it makesHow you pay
Magnific (the default)Its whole image and video API. Images: Mystic, Magnific One, Nano Banana, Seedream, GPT Image, Flux, Ideogram, Recraft, Image Expand, Remove Background. Video: Seedance, Kling, Veo, MiniMax, Wan, PixVerse, Runway, LTX. Upscalers: Magnific, Topaz and more.Credits from your Magnific plan.
videorouter.shSeedance 2.5 and Seedance 2.0 video, on a host you pick or on the cheapest host.Pay as you go, from your videorouter balance.
HiggsfieldSeedance 2.0 video, up to 4K. Seedance 2.5 video, up to 1080p, and Seedance 2.5 video edit and video extend.Pay as you go, from your Higgsfield API balance (not your Higgsfield plan credits).
Atlas CloudSeedance 2.5 video, up to 1080p, with a cheap 480p draft that you then finish at 1080p.Pay as you go, from your Atlas Cloud balance.
fal.aiCloud mattes of a clip: roto by prompt and depth (right-click a layer › make matte; Cloud mattes). Not in the New Generation form.Pay as you go, from your fal balance.
  1. Open Settings › Keys: click the gear at the top right, or press ⌘, / Ctrl+,. The menu is Starlight › Settings….
  2. Click set on the Magnific, videorouter, Higgsfield or Atlas Cloud row.
  3. Paste the key and click save. A Higgsfield key has two parts, a key ID and a secret: paste both as KEY_ID:KEY_SECRET.
  • A row with a key has replace and remove instead of set.
  • The panel's set up keys link and the form's add one link also open this page.
  • Starlight checks the key with the provider before it stores it. While it checks, the button reads checking…. So add keys while you are online.
  • The key is stored encrypted on this machine only. It is never shown again.
  • ⌘K compose needs no key: it sends your words to the Claude panel. Only the openrouter planner needs a key, the OpenRouter key. All keys: Settings › Keys.

Check the price before you spend

Starlight prices every job before it spends money. Most prices are estimates.

  1. Fill in the form. The price beside generate changes as you edit. A ≈ marks an estimate.
  2. Click ⓘ to read the details and the warnings. A job that costs more than your ask above limit gets a warning: this costs … — over the $5 warning line.
  3. Fix anything that is shown in red. generate stays off until you do.
  4. Click generate. When the job is done, the panel header adds its cost.
TopicWhat to know
Magnific pricesMost are credits × your price per credit (Magnific $/credit, default $0.001). Magnific never reports the real cost, so the estimate stays. Check your Magnific dashboard.
videorouter pricesThe host's price plus 2.5%. videorouter charges when the job starts and refunds a failed job. When it reports the real cost, the ≈ goes away.
Higgsfield pricesSeedance 2.0 is priced by the clip's pixels and seconds: about $0.68 a second at 1080p and $1.56 at 4K at list price. Seedance 2.5 is about $1.14 a second at 1080p and $0.46 at 720p. With Seedance 2.5, the seconds of any video you give it (a reference video, or the video to edit or extend) cost the same as new seconds, so the price line warns you. An edit has no price before it starts, because its length is the video's. Higgsfield's pricing page shows about 30% off list. When a job starts, Starlight asks Higgsfield for its price and records that, so the ≈ goes away when the job is done. Higgsfield refunds a failed job.
Atlas Cloud pricesSeedance 2.5 is about $0.59 a second at 1080p, $0.30 at 720p and $0.14 at 480p. A draft costs the same as a 480p clip. Its finish at 1080p costs the same as a 1080p clip of the same length: a 4 s draft is about $0.56, and its finish about $2.37. The price is an estimate, because Atlas Cloud bills by the clip's video tokens. The job keeps Atlas Cloud's own figure. A failed job is refunded.
price unknownSome models have no published price. The price line warns you. You can still run them from the panel. Claude runs one only after it tells you there is no price and you say yes.
The headerspend $12.40 · 31 renders, then the grade counts, then one line per provider. Hover the spend for what NG jobs cost, by reason. Refused and failed jobs cost nothing.
BalancesClick $ in the panel's title row to see what's left on each service. The videorouter and Atlas Cloud balances also show in Settings › Keys and in the tooltip of the header's provider line. Magnific and Higgsfield do not share their balance: see their dashboards.
Spend limitsask above ($5), MCP cap ($20), plan cap ($1) and Magnific $/credit ($0.001) are in Settings › Generation. The defaults are in brackets.
⌘K composeThe approve button shows the plan's total. An OpenRouter planner also reports what the planning cost. That cost is its own line in the header.
cancelMagnific, videorouter and Atlas Cloud cannot stop a job. A job you cancel may still run, and you may still pay for it. Higgsfield stops a job that has not started yet and refunds it.

Preview a result

The preview shows one result full size in the canvas pane.

  1. Click a finished job in the panel. Or select its row and press ⏎ / Enter.
  2. Look at the result. It opens fitted to the pane, never cropped. A video plays in a loop, without sound.
  3. Zoom and pan, the same as on the canvas:
    • Scroll, or pinch on a trackpad, to zoom in or out where the pointer is.
    • Drag the picture to move it. ⇧ + scroll, or a sideways swipe, moves it too.
    • Press + or − to zoom in steps. Press F to fit it again.
    • Double-click to see it at 100% (one pixel of the picture on one pixel of the screen). Double-click again to fit it.
    • The line above the picture shows the zoom, for example · 100%. A new result always opens fitted.
  4. Press ← or → to see the previous or next result in the list.
  5. Press 1–6 to grade it, or 0 to clear the grade.
  6. Press Esc, or click the × at the top right of the pane, to close it.
  • You can also open it from the thumbnail, with a double-click, or with view it in the job's menu. Clicking a failed or running job only selects it.
  • An asset opens here too: double-click an image or video tile in the Assets panel. ← and → step through the images and videos in that folder, in the panel's order, and the tile on show is marked. Above it: name · width×height · file size. It has no grades and no import. A file that is online only (linked media) does not open.
  • ⏎ / Enter on the job on show, or close the viewer in its menu, closes the preview.
  • Above the result: label · model · size · cost · grade. Below it: the six grades, import, and ← 3/14 →. A result made from a stage capture also has stage <id>, which opens that stage.
  • import reads in assets when the result is already imported. stage <id> is grey until you open the scene of that stage.
  • Click a grade button to set that grade. Click the current grade again to clear it. After NG, a menu asks why (optional).
  • The ← and → buttons step through the list too. A job with several results is several steps.
  • Click a video to pause or play it. A drag moves it instead. Drag the bar under it to move in time.
  • Starlight stops drawing the surfaces while the preview is open. When it closes, the canvas comes back as you left it, with your view and focus.
  • It also closes when you click in the node graph or the timeline, or undo a scene edit. Undoing a grade keeps it open.
  • Changing the scene or the project closes it too.
  • The canvas corner's focus button closes the preview first, then focuses. View › Focus on Comp leaves it open and says close the preview to focus. ⇧S / Shift+S opens or closes the Stage panel and leaves the preview open, because the panel sits beside the canvas.
  • Keys that would change the hidden canvas do nothing. These still work: ⌘Z / Ctrl+Z, ⌘S / Ctrl+S and ⌘K / Ctrl+K. Space, J and K and the panel keys work too (all keys).
  • Some files cannot show here, for example a ProRes .mov. The preview says so and offers reveal.
  • A result of any size shows here, imported or not. A video starts at once, and you can drag to any point in it.
  • If the file of a result is gone (moved or deleted), the preview says so and offers reveal.
  • If the pointer is over the timeline, or keyframes are selected there, the arrow keys and Esc go to the timeline first.

Grade results

A grade is your mark for how good a result is. It helps you find the best results later.

  1. Click a job's row to select it.
  2. Press a key from 1 to 6 (see the table). Or right-click the job and click a grade.
  3. If you picked NG from the menu, a second menu asks why. Pick a reason, or press Esc to skip it. The 5 key sets NG without asking.
KeyGradeIt means
1circledThe one: this goes on the walls.
2selectA keeper, but not yet the one.
3holdNot decided: look at it again.
4softNearly: the right idea, done wrong.
5NGNo good: do not spend more on it.
6refNot a shot, but a frame worth generating from.
0Clears the grade. Pressing the key of the current grade again also clears it.
  • A grade shows as a coloured line down the left edge of the row. A job graded NG is dimmed.
  • A grade is an edit: ⌘Z / Ctrl+Z takes it back.
  • ↑ and ↓ move to the row above or below.
  • To grade several jobs at once, select them first (Select several jobs). The key then grades them all.
  • In the menu, click the current grade again to clear it.
  • NG reasons: artifacts, text, framing, resolution, motion, loop, color, off brief, other. To change the reason later, use why NG in the job's menu.
  • The header counts the jobs per grade, and the jobs with no grade. Click a count to show only those jobs. Click it again to show all.
  • Claude sees your grades. When Claude runs in the Claude panel, each grade you set goes to it as one line, for example Graded W tile 1/2 (gmvk7zkq6-e1dc0e): ng, motion. Grades you set within a few seconds go together in one line. Claude then knows what you think of each take, for example that a tile must be made again. Nothing is sent when the Claude panel is closed.

Select several jobs

Select several jobs to grade, remove or mention them all at once. This works in both views.

A range of jobs.

  1. Click the first job.
  2. Hold ⇧ / Shift and click the last job. Every job between the two is selected too, in the order the list shows them.

Jobs one by one.

  1. Click the first job.
  2. Hold ⌘ / Ctrl and click each other job.
  3. To take a job out, hold ⌘ / Ctrl and click it again.

With the keyboard. Click a job. Then hold ⇧ / Shift and press ↑ or ↓. The range grows or shrinks by one job. Press Esc to go back to one job.

Do something to all of them.

  1. Right-click one of the selected jobs, or click ⋯ on its card.
  2. Pick an item. Each item says how many jobs it changes, for example remove 5.
Menu itemWhat it does
gradeGives every selected job the grade you click. A ring shows the grade they all have. Click it again to clear it on all of them.
why NGWhen every selected job is NG: sets the reason on all of them.
cancel 2Cancels the selected jobs that still run.
retry 3Runs each selected job again, as a new job. Jobs that still run are not counted. Starlight asks first, because each new job costs money. The new jobs are then selected.
import 3 to assetsCopies the result of each finished job into assets/. Jobs that are in assets already are not counted.
mention 5 in ClaudeTypes the reference of every selected job into Claude's prompt, in the order of the list. It does not send it.
remove 5Deletes the jobs and their downloaded files. Starlight asks once, for example Remove 5 generations?. A running job is not removed: the item says skips 1 running. Cancel it first.
  • Press 1 to 6 to grade every selected job, or 0 to clear the grade. When all of them have that grade already, the key clears it. ⌘Z / Ctrl+Z takes back the grade of all of them in one step.
  • In the Claude panel, right-click and pick reference the 5 selected generations. It types the references of all the selected jobs (References).
  • The last job you click is the main one. ⏎ / Enter shows its result.
  • Some items work on one job only: view it, reveal in finder, copy prompt, generate another like it…, finish at 1080p, place on canvas, use as start frame, use as reference, upscale… and refine…. They are not in this menu. Click one job, without a key, to use them.
  • A click without a key selects only that job again. A right-click on a job that is not selected also selects only that job.
  • The buttons on a card (cancel, retry, import) change only that card's job.
  • A drag moves one job only.
  • On a Mac, Control-click works like ⌘-click. It does not open the menu. A right-click or a two-finger click opens it. ⌥ / Alt-click works like ⌘ / Ctrl-click too.
  • The selection stays when you change the sort. When a filter or a search hides a selected job, that job leaves the selection. Starlight never changes a job that you cannot see.
  • A job that is removed leaves the selection too.

Use a result

The job menu puts a result into your scene, or starts a new job from it.

Drag it onto a surface. Drag a done job, or its picture, onto a surface on the canvas. It becomes a new layer there, like an asset (Drop media on a surface). If the result is not in Assets yet, Starlight imports it first. It imports it only once. A job with several results drags the result that is on show. An open preview closes when you start to drag, so you can see the surfaces. Drop it on the node graph to make a node, or on the Assets panel to import it. A job that is still running, or that failed, does not drag.

Tell Claude about it. Drag a job, its picture or a page number onto the Claude panel. Or double-click the job, or right-click it and pick mention in Claude. Starlight types the job's reference into Claude's prompt. It does not send it (Point Claude at what you mean).

  1. Right-click a job, or click ⋯ on its card.
  2. Pick an item from the table below.

The menu shows only the items that fit the job. Its first line is the job's id and status. Under it are the six grades. The full menu list: Job menu.

Menu itemWhat it does
why NGOn an NG job: pick or change the reason.
reveal in assetsOn an imported job: opens the Assets panel and flashes the file.
view itOpens the preview (Preview a result). It reads close the viewer while this job is on show.
reveal in finderShows the result's folder. On Windows the item says show in explorer. Grey, with no files yet, before the job is done.
copy promptCopies the prompt.
generate another like it…Opens the form, filled in from this job, so you can change it and run it. It reads edit and try again… after a failure, and duplicate… while the job runs.
retryRuns the same job again, without changes, as a new job.
cancelWhile the job runs: Starlight stops following it. The provider may still finish it and charge you (cancel).
finish at 1080pOn a finished Seedance 2.5 draft (videorouter or Atlas Cloud): makes the same take again at 1080p, as a new job. It is also a button on the job. The right side of the row says how many of the 7 days are left. The row is grey when the draft cannot be finished, and says why: draft expired, or on videorouter final already made or final in progress (Draft).
show the finalOn a draft that has a 1080p final: selects the final's job and scrolls to it.
place on canvasImports the result if needed. Then places it in the middle of the scene, in the comp (a named group of layers) you are working in. The new layer is an unsaved edit: ⌘S / Ctrl+S saves it, ⌘Z / Ctrl+Z takes it away.
import to assetsCopies the result into assets/. Then drag it from the Assets panel onto a surface. The card's import button does the same. Grey, with in assets, once it is imported.
use as start frameOpens the form with this result as the first frame of a video.
use as referenceOpens the form with this result as a reference image.
upscale…Opens the form with this result as the source. Pick an upscaler (Upscale a result).
refine… ⌘K / Ctrl+KOpens ⌘K compose with this result. Say what to change. Claude makes the new generation and places it.
removeDeletes the job and its downloaded files. Starlight asks first. An imported copy stays in your assets. A running job cannot be removed: cancel it first.
  • use as start frame, use as reference and upscale… show only when a model can take the result that way. The form opens on a model that fits.

Tip: video for a surface. First make a still image and grade it. Then use that still alone as Seedance's start frame. If the video must be bigger, use a video upscaler last.

Upscale a result

An upscale makes a result bigger. A tiled upscale makes it as big as a whole surface, or as big as the panorama (several surfaces side by side).

  1. Right-click the job and choose upscale…. Or click + new and add the image as the source.
  2. In model, pick Magnific Creative upscaler or Magnific Precision V2. For a video, pick a Magnific video upscaler or Topaz.
  3. If the result will be 25.3 megapixels or less, set the scale in settings and click generate. You are done.
  4. For a bigger result, turn on tile to surface size under tiled upscale.
  5. Pick the target: a comp across several surfaces (for example panorama · 24640×1600 · 5 surfaces), one surface, or custom size. For a custom size, type it in size, for example 24640x1600.
  6. In write into, keep the open scene. Pick no scene (comp file only) to only write the comp file.
  7. Leave re-point <comp>'s surfaces on. Those surfaces then show the new comp instead of the old one.
  8. If you like, change the new comp's name in comp. The default is <comp>-hd, or <label>-hd when nothing is re-pointed.
  9. Read the price: N tiles × $… = $…. Then click generate N tiles.
  • Why tiles: one upscale stops at 25.3 megapixels, and Starlight draws images up to 8192 pixels on a side. So Starlight cuts the image into overlapping tiles.
  • tile to surface size shows only for Magnific Creative upscaler and Magnific Precision V2.
  • Starlight picks the scale from the target size and the source size. So the Scale setting is hidden while tiling is on.
  • Under the price, a line shows the plan, for example 4× · 6160×400 → 24640×1600 · seams on N, E2, W. Another line says which comp it writes, and where.
  • A plan can have 64 tiles at most. Neighbouring tiles overlap by 256 pixels.
  • The new comp shows at once, with grey placeholders. Each tile replaces its placeholder when it lands.
  • The seams, where two tiles overlap, blend smoothly. They stay at least 400 pixels away from the edge of a surface.
  • The panel shows the set as one card, with its tiles under it (tiles 2/4).
  • retry on the set runs only the tiles that are not placed yet. cancel stops its running tiles.
  • Creative invents new detail in each tile, so a seam can show. To stay closer to the original, use Precision V2, or set a negative Creativity.
  • To undo the scene change, go back to the version before the tiled upscale: … save (Versions). The tiles stay in assets/gen/.

Tile a surface for AI video (Tile Plan)

A surface can be much bigger than an AI video. The N surface is 6400×1600 pixels. Seedance makes 2206×946 at 21:9. Tile Plan cuts the surface into zones. Each zone is one video. When the videos are done, Starlight puts them back on the surface as one picture.

Make a plan.

  1. Right-click a surface on the canvas, or its surface node in the node graph.
  2. Pick tile plan…. The Tile Plan panel opens at the right side of the canvas.
  3. Pick the model: Seedance 2.5 Pro, Seedance 2.0 Pro or Seedance 2.5 on VideoRouter.
  4. Pick the tier: 1080p, or 4K. Only Seedance 2.0 Pro makes 4K.
  5. Pick the shape: 21:9 or 16:9.
  6. Set the overlap. The default is 20%. Neighbour zones share at least this much.
  7. Click plan zones. The zones show on the surface as numbered outlines. The overlaps are hatched.

The shapes and the scale. Each zone is as tall as the surface. The video is made small, then it is scaled up to the surface height.

ShapeMade atZone on a 1600 px surfaceScale
21:9, 1080p2206×9463731×1600×1.69
16:9, 1080p1920×10802844×1600×1.48
21:9, 4K4398×18863731×1600×0.85 (smaller, no upscale)
16:9, 4K3840×21602844×1600×0.74 (smaller, no upscale)
  • The panel shows the scale. A scale over ×1.5 gets a warning: the picture is softer. 4K needs no upscale.
  • At 20% overlap: N and W need 2 zones at 21:9 or 3 at 16:9. S and E2 need 2. E1 needs 1 at 21:9 (its sides are cut off) or 2 at 16:9.
  • One row only. A seam across the surface would cut through people and faces. A cut through a face shows the most.
  • Each start frame is exactly the size Seedance makes. So Seedance does not crop it again.

Move the zones and the seams.

  • A seam is where two videos blend. It is the bright line inside an overlap. The shaded band around it is the blend (the crossfade).
  • Drag a zone by its number to move it left or right. It keeps its size and the full surface height.
  • Drag a seam line to move the blend inside its overlap.
  • Use this for fast motion. Two videos do not move the same way, so fast action looks doubled in the blend. Put the seam where nothing moves fast.
  • Set crossfade in the panel to make the blend wider or narrower (in surface pixels). Empty means automatic: the overlap, at most 1024 pixels.
  • Claude can give each seam its own crossfade width. The box then says per seam and lists them. Type one number to use one width for all seams again.
  • Every change is one undo step.

Generate the tiles.

  1. Click generate tiles….
  2. Starlight renders each zone of the surface as a start frame. It saves them in assets/tiles/<scene>/<wall>/.
  3. One form opens for all the tiles. Type one prompt. It is used for every tile. Describe the motion: the start frame is the picture. See Write the prompt for tiles below.
  4. Keep the seed. Every tile gets the same seed and the same settings.
  5. Turn on loop if you want each video to end on its start frame (Seedance on Magnific only).
  6. Read the total price. Then click generate N tiles. Nothing is spent before you click it.

Write the prompt for tiles. Each tile is a separate video. The tiles must still match at the seams.

  1. Name what the people do, for example the crowd sways and waves their arms. If you do not name it, the people often stand still.
  2. Keep the motion small and in one place: a flag, hands, hair, a light that blinks.
  3. Ask for no change in the light, the colours, the sky or the time of day. One tile that gets darker, or a sky that turns purple, does not match its neighbours.
  • Static camera is always on for tiles. A camera move would be different in each tile, and the seams would not match.
  • Steady light is also always on. Starlight adds this sentence to the end of every tile's prompt: The lighting and colours stay the same for the whole clip.
  • The form tells you when the clip length does not fit the scene loop. See Make the tiles loop below.
  • Each generate tiles… renders new start frames. Starlight then deletes the old start frames of this surface that no batch used, once they are an hour old (a day in a shared project). A start frame that a batch, a video or a scene uses is never deleted.
  • The jobs show in the Gen panel as N tile 1/3, N tile 2/3 and so on.
  • To make one tile again, right-click its job and pick retry. The new video replaces the old one on the surface.

Put the tiles back.

  • When all the tiles are done, Starlight puts them on the surface by itself. It makes one comp, tiles-<wall>, and places it on top of the surface. Your own layers stay under it.
  • Click assemble tiles to do it now, with the tiles that are done.
  • Moving a seam or changing the crossfade later puts the tiles back again. It never generates again.
  • A zone with a finished video does not move. Its seams still move.

Check the seams. Starlight can measure the seams for you. It reads each video on the surface and compares two videos where they overlap.

  1. Put the tiles on the surface first (assemble tiles).
  2. Click check seams in the Tile Plan panel. A surface takes about one second.
  3. Read the lines under the button. A red line is a problem. Look at that seam on the surface, and play the scene.

The check looks for these problems:

  • Ghosting. The two videos show different things in the overlap. For example, a person dances in one video but not in the other. The blend then shows the person twice. The check says when it happens (for example at 0.5–3.0 s) and where.
  • Colour step. One video is brighter, or has another colour, at the seam. For example, the sky is purple in one video and orange in the other.
  • Drift. The picture moves during the video. With the static camera it stays under 1 pixel.
  • Light change. A tile gets darker or brighter during the video, or a part of it does.
  • Little motion. A tile moves much less than the other tiles. Its people may not move. Make that tile again (right-click its job, retry).

The check saves what it found in the plan, as one undo step. It never makes a video and never spends money.

Suggested seams. After a check, the panel can show a suggested seam: a place and a crossfade width.

  • Where the two videos agree, it suggests a wide crossfade. A wide blend hides small colour differences.
  • Where people move, it suggests a narrow crossfade at the calmest place. A narrow blend shows a double picture over fewer pixels.
  1. Read the line, for example x 3156 · crossfade 256 px.
  2. Click apply. The seam moves and the crossfade width changes. It is one undo step. Nothing is generated.
  3. Play the surface and look at the seam. Check the seams again if you want.
  • Each seam gets its own place and its own crossfade width.

Colour match. The check also measures the colour difference in each overlap. Then it corrects the next tile (on the right) so that its colour matches the tile before it.

  • The correction is strongest at the seam. It fades to nothing across the tile.
  • It is on after a check. To turn it off, clear colour match in the panel. The measurement stays, so you can turn it on again.
  • It is one fixed correction for the whole video. If one tile changes its light during the video, one correction cannot match it. Then the check says so and adds no correction. Make that tile again.
  • It changes the colour of the video that is already there. It does not play the video a second time.

Keep design detail sharp. The videos are scaled up, so small text and fine detail are soft. Where nothing moves, Starlight can show your own design instead of the video.

  1. Check the seams first. The check makes a detail mask: white where every video stays still and keeps its light.
  2. Turn on keep design detail sharp in the panel. The panel shows how much of the surface it covers.
  3. Where the mask is white, the videos are cut away. Your design under them shows at full sharpness. Moving areas stay video.
  • It is off by default.
  • The cut is a normal mask on the surface. Select the tiles on the surface and change it in the matte section: feather, opacity, invert. A new check keeps your settings.
  • To add or remove an area, open the mask image in an image editor and paint it. White shows the design. Black keeps the video. The image is assets/tiles/<scene>/<wall>/detail-….png. Starlight loads it again when you save it.
  • Make the check again after you change the design or make a tile again. The mask is made from the videos on the surface.

Make the tiles loop. A video that is shorter than the scene loop plays again from its start. If the scene loop is not a whole number of videos, the tiles jump when the scene loops. For example, 4.04 s videos in a 10 s loop jump: 10 s is 2.48 videos. The panel then shows a red line.

  1. Put the tiles on the surface first (they do this by themselves, or click assemble tiles).
  2. Click make tiles loop.
  3. Every tile gets the same Make Loop cut (see Make a clip loop), so the tiles stay in step. The cut uses the length of the shortest video.
  4. The scene loop is set to the length of the loop.
  • The plan remembers the loop. Moving a seam, changing the crossfade or a new video for one tile keeps the loop.
  • A new generate tiles… drops the loop: make the new tiles loop again when they are done.
  • It is one undo step. Or set the scene loop by hand to the length the red line names.
  • A loop plays each video as two halves, so the surface plays twice as many videos at once. Play the room and check that it is still smooth (the ⇧I / Shift+I frame-rate display, or ask Claude for playback_stats).

Ask Claude. Claude can do all of this for you:

  • plan_tiles, generate_tiles and assemble_tiles plan, make and put back the tiles. generate_tiles first shows the price and the MCP spend cap for each tile (Settings › Generation). It spends only when Claude calls it again with confirm: true. If the tiles have no price, Claude asks you first.
  • set_tile_seams moves the seams and sets the crossfade, the same as dragging in the panel. Ask, for example: move the seam on W off the singer's face.
  • make_loop with the surface's name makes the tiles loop, the same as make tiles loop.
  • tiles_check with the scene and the surface checks the seams. set_tile_seams with auto: true applies the suggested seams. set_tile_match turns the colour match and the sharp detail on or off.

Words. Zone: one part of the surface, one video. Overlap: where two zones cover the same pixels. Seam: where two videos blend. Crossfade: the blend, from one video to the next. Start frame: the picture a video begins with. Scene loop: the length after which the scene starts again.

Words for the check. Ghosting: two different pictures in one blend, so things look doubled. Colour match: the colour correction of the next tile at a seam. Detail mask: the black and white picture of where nothing moves.

Where results go

Starlight keeps every result and a record of how it was made.

WhatWhereShared with others?
Downloaded resultsgenerations/<id>/ in the project folder, as soon as a job finishes. reveal in finder opens it.No: this machine only, not versioned.
Imported resultsassets/<label>-<id>.<ext>. Without a label, the model's name is used. A job with several results adds -1, -2 and so on.Yes, like any asset.
⌘K compose resultsassets/gen/Yes.
Transparent cut-outsassets/<label>-alpha-<id>.pngYes.
How it was madegeneration.json beside the download, and <file>.gen.json beside the imported assetThe .gen.json file travels with the asset.

The record holds the prompt, model, settings, inputs, cost and grade. See What the project remembers.

What needs internet

Generations need the internet. Most other work in this panel does not.

  • Needs internet: ⌘K planning, every generation (sending it, its progress and its download), and saving a key.
  • Works offline: the list, previews of downloaded results, grading, import, place, and stages (capture too).
  • A running job continues if the connection drops. Starlight keeps checking. sync checks now.
  • If the connection drops while a job is being sent, Starlight marks it failed. It never sends it again, because the provider may have charged you already. Check the provider's dashboard.
  • See Working offline.

On this page