Provide a topic/product/event. Optional mode, brand hues, exact short title/subtitle/CTA, ratio, quantity (one to four), permitted logos and screenshots refine it. Ask only for missing essential topic, requested absent assets or exact wording. Inspect every image and label it as style reference, edit target or exact asset for unchanged-content insertion.
Honor an explicit mode first. Otherwise route general editorial/launch briefs to Classic Soft-Focus Blue, explicit hue requests to Color Soft Focus and the documented organic/warm-motion/fruit/beam/material/scenic cues to their respective systems. Do not randomly mix modes. Color Soft Focus offers Teal Growth, Warm Coral, Lemon Cyan and Brand Monochrome; preserve the chosen hue relationship.
For a series, lock mode, palette/photo contract, white balance, tonal/saturation range, primary direction and type before generating. Use a shared approved background variation only where ratio and visual intent remain appropriate; recompose natively for each requested ratio. Fruit can vary species across images, but one image contains only one species and the photography contract stays fixed.
Plan background geometry and safe zones. Broad-brush modes use one continuous saturated gesture with melted edges and at most a faint echo, not grain/smoke/ribbons. Organic uses two or three large unrecognizable depth zones; sunlit motion one or two broad warm arc groups; fruit uses credible close texture/controlled droplets; beams use two to five varied directional groups with roughly 30–55% dark title space. Material/scenic modes retain credible surfaces/light rather than generic technology decoration.
Lock available fonts and exact copy. Use at most one Chinese and one English family, bold/heavy title and at least semibold subtitle; default all text/CTA to #FFFFFF. Keep text-only copy centered, one hero sentence at most two lines. Put exact copy in the production brief, not the background generation payload. Adjust background/placement for contrast rather than adding a dark panel, text outline or glow.
Use FAL GPT Image generation for a fresh text-free background, or its edit endpoint only for material the user intends to change. The bundled route needs Node.js 20+, FAL_KEY and authorization for each paid task; Sharp is required for local finishing. Keep exact logos/screenshots out of generation inputs, and never invent prices, customers, performance or partnerships.
Save a prompt and fresh attempt/task/output paths before submission. The helper records an intent, then the request ID, and resumes matching settings rather than automatically replacing failed/uncertain tasks. It lacks an exclusive task claim/processing lock, so run a task in one process and do not promise race-safe exactly-once charging. If submission is ambiguous, preserve records and inspect provider history before authorizing another attempt.
Pass editable references as HTTPS URLs/data URIs; local files require encoding rather than simply supplying a path to the helper. Its input digest binds the submitted strings/settings, not remote reference bytes. Choose a matching ratio preset or supported custom dimensions (up to 3840 long edge and model pixel limits), use high quality and record actual pixels. A checked ratio does not establish the requested exact resolution or native-detail level.
Compose locally from a spec using Sharp: background ratio must match, assets default to proportional contain, and cover-cropping needs explicit permission. Put logos/screenshots in bounded boxes, keep important content/safe space and render exact text with escaped SVG strings and available fonts. The helper requires WebP and limits each canvas dimension to 640–3840; text lines/coordinates are explicit, not an automatic typography/overflow solver.
Compare the rasterized result with exact copy and supplied assets: spelling, punctuation, data, icon geometry, logo colors/proportions, screenshot content and safe margins. Final encoding is lossy WebP, so original pixels are not guaranteed; keep source assets and composition spec. Save each attempt separately—existence checks/rename do not provide a concurrency-safe overwrite guarantee.
Perform all fourteen visual review categories at full/thumbnail size and a same-size series lineup: routing, applicable brush/organic/sunlit/fruit/beam grammar, highlights, palette, consistency, surface, typography, text styling, information fidelity and ratio. A text scanner or WebP header check cannot substitute for this. The bundled validate.mjs requires release-only files absent from the installation ZIP and cannot be treated as a ready-to-run installed output checker.
If a result fails, identify one primary defect and change only that property while holding approved parts fixed. A new paid background/edit is a separately authorized task, not an automatic retry. Deliver actual output paths/counts, mode/ratio/dimensions, exact prompt, FAL request/task record and QA limitations without credentials or full provider responses.