Unrestricted Open-source alternative to AI video platforms — Free AI image & video generation studio with 600+ models (Flux, Midjourney, Kling, Sora, Veo). No content filters. Self-hosted, MIT licensed.
JavaScript ai-art-generatorai-image-generationai-video-generationfal-ai-alternativegenerative-aiimage-to-videoinvideo-alternativekling-ailipsynclitellm-alternativemidjourney-alternativemuapiopen-sourceopenrouter-alternativeseedance2sora-alternativetext-to-imagetext-to-videouncensoredwan-video
fix(studio): support required image inputs
antilya5cebd19e3d4d
diff --git a/packages/studio/src/components/ImageStudio.jsx b/packages/studio/src/components/ImageStudio.jsxindex 9ac70e8f..0c6b5a6c 100644--- a/packages/studio/src/components/ImageStudio.jsx+++ b/packages/studio/src/components/ImageStudio.jsx@@ -5,6 +5,11 @@ import toast, { Toaster } from "react-hot-toast";import { generateImage, generateI2I, uploadFile } from "../muapi.js";import { formatErrorMessage } from "../utils/formatError.js";import { scopedPersistKey, migrateLegacyPersistKey } from "../persistKey.js";+import {+ getAuxiliaryImageInputs,+ getImageInputContract,+ getImageInputValidationError,+} from "../imageInputContracts.js";import DrawModal from "./DrawModal.jsx";import MobileGenerationActions, {GenerationCopyButtons,@@ -21,7 +26,6 @@ import {getMaxImagesForI2IModel,getEffectsForI2IModel,getDefaultEffectForI2IModel,- getI2IModelById,} from "../models.js";import {PROMPT_CONTROL_LABEL_CLASS,@@ -112,7 +116,11 @@ function UploadButton({ apiKey, maxImages, onSelect, onClear, initialUrls = [],// Sync initialUrls from parent (e.g. restored from localStorage)useEffect(() => {- if (initialUrls && initialUrls.length > 0) {+ if (!initialUrls?.length) {+ if (selectedEntries.length > 0) setSelectedEntries([]);+ return;+ }+ if (initialUrls.length > 0) {// Avoid infinite loops by only updating if URLs actually changedconst currentUrls = selectedEntries.map(e => e.url);const isSame = initialUrls.length === currentUrls.length && initialUrls.every(u => currentUrls.includes(u));@@ -311,11 +319,13 @@ function UploadButton({ apiKey, maxImages, onSelect, onClear, initialUrls = [],{lastUploadProgress}%</span></div>- ) : label === "Swap Face" ? (+ ) : label ? (hasSelection ? (<img src={selectedEntries[0].url} alt="" className="w-full h-full object-cover" />) : (- <span className="text-[10px] font-bold text-white/50">Face</span>+ <span className="px-1 text-center text-[8px] font-bold leading-tight text-white/50">+ {label.replace(/\s+image$/i, "")}+ </span>)) : (<svg@@ -358,6 +368,7 @@ function UploadButton({ apiKey, maxImages, onSelect, onClear, initialUrls = [],ref={triggerRef}type="button"title={triggerTitle}+ aria-label={triggerTitle}onClick={(e) => {e.stopPropagation();setPanelOpen((o) => !o);@@ -380,7 +391,7 @@ function UploadButton({ apiKey, maxImages, onSelect, onClear, initialUrls = [],<div className="flex items-center justify-between px-1 pb-3 mb-2 border-b border-white/5"><div className="flex flex-col gap-0.5"><span className="text-xs font-bold text-secondary">- Reference Images+ {label || "Reference Images"}</span>{isMulti && (<span className="text-[9px] text-muted">@@ -920,7 +931,7 @@ export default function ImageStudio({// ── Prompt / upload state ───────────────────────────────────────────────const [prompt, setPrompt] = useState("");const [uploadedImageUrls, setUploadedImageUrls] = useState([]);- const [swapImageUrl, setSwapImageUrl] = useState(null);+ const [auxiliaryImageUrls, setAuxiliaryImageUrls] = useState({});const [uploadHistory, setUploadHistory] = useState([]); // persisted reference images history// ── UI state ────────────────────────────────────────────────────────────@@ -1083,6 +1094,10 @@ export default function ImageStudio({// ── Derived: current model lists & helpers ───────────────────────────────const currentModels = imageMode ? i2iModels : t2iModels;+ const currentMode = imageMode ? "i2i" : "t2i";+ const currentModel = currentModels.find(({ id }) => id === selectedModelId);+ const currentInputContract = getImageInputContract(currentModel, currentMode);+ const auxiliaryImageInputs = getAuxiliaryImageInputs(currentModel, currentMode);const currentAspectRatios = imageMode? getAspectRatiosForI2IModel(selectedModelId): getAspectRatiosForModel(selectedModelId);@@ -1104,11 +1119,11 @@ export default function ImageStudio({setUploadedImageUrls(newUrls);if (!imageMode) {+ setAuxiliaryImageUrls({});// Find the i2i sibling of the currently selected t2i model.// Many models follow conventions, but some have completely irregular names —// those are handled via a hardcoded exceptions map.const curId = selectedModelId;- const i2iIds = new Set(i2iModels.map((m) => m.id));// Hardcoded exceptions for models with irregular t2i → i2i namingconst EXCEPTIONS = {@@ -1158,6 +1173,7 @@ export default function ImageStudio({const handleUploadClear = useCallback(() => {setUploadedImageUrls([]);+ setAuxiliaryImageUrls({});setImageMode(false);// Find the t2i parent of the currently selected i2i model (reverse of upload logic)@@ -1211,14 +1227,13 @@ export default function ImageStudio({: getResolutionsForModel(m.id);if (!nextImageMode && imageMode) {setUploadedImageUrls([]);- setSwapImageUrl(null);}setImageMode(nextImageMode);setSelectedModelId(m.id);setSelectedModelName(m.name);setSelectedAr(ars[0] || "1:1");setSelectedQuality(resolutions[0] || null);- setSwapImageUrl(null);+ setAuxiliaryImageUrls({});if (nextImageMode) {setMaxImages(getMaxImagesForI2IModel(m.id));const effects = getEffectsForI2IModel(m.id);@@ -1247,6 +1262,7 @@ export default function ImageStudio({setCurrentImageUrl(null);setPrompt("");setUploadedImageUrls([]);+ setAuxiliaryImageUrls({});setImageMode(false);const firstT2I = t2iModels[0];const ars = getAspectRatiosForModel(firstT2I.id);@@ -1263,21 +1279,14 @@ export default function ImageStudio({const handleGenerate = async () => {if (generating) return;- if (imageMode) {- if (uploadedImageUrls.length === 0) {- alert("Please upload a reference image first.");- return;- }- const modelInfo = getI2IModelById(selectedModelId);- if (modelInfo?.swapField && !swapImageUrl) {- alert("Please upload a swap face image.");- return;- }- } else {- if (!prompt.trim()) {- alert("Please enter a prompt to generate an image.");- return;- }+ const inputError = getImageInputValidationError(currentModel, currentMode, {+ prompt,+ primaryImageUrls: uploadedImageUrls,+ auxiliaryImageUrls,+ });+ if (inputError) {+ alert(inputError);+ return;}onGenerationStart?.();@@ -1293,8 +1302,8 @@ export default function ImageStudio({images_list: uploadedImageUrls,image_url: uploadedImageUrls[0],aspect_ratio: selectedAr,+ ...auxiliaryImageUrls,};- if (swapImageUrl) genParams.swap_url = swapImageUrl;if (prompt.trim()) genParams.prompt = prompt.trim();if (currentQualityField && selectedQuality) {genParams[currentQualityField] = selectedQuality;@@ -1346,11 +1355,9 @@ export default function ImageStudio({};const placeholderText =- uploadedImageUrls.length > 1+ uploadedImageUrls.length > 1 && !currentInputContract.promptRequired? `${uploadedImageUrls.length} images selected — describe the transformation (optional)`- : imageMode- ? "Describe how to transform this image (optional)"- : "Describe the image you want to create";+ : currentInputContract.promptPlaceholder;// ── Render ───────────────────────────────────────────────────────────────return (@@ -1536,20 +1543,38 @@ export default function ImageStudio({initialUrls={uploadedImageUrls}persistedHistory={uploadHistory}onHistoryChange={setUploadHistory}+ label={+ currentInputContract.primaryImageLabel === "Reference image"+ ? null+ : currentInputContract.primaryImageLabel+ }/>)}- {/* Swap Image Upload Trigger */}- {imageMode && getI2IModelById(selectedModelId)?.swapField && (+ {/* Role-specific image inputs */}+ {auxiliaryImageInputs.map(({ field, label }) => (<UploadButton+ key={`${selectedModelId}:${field}`}apiKey={apiKey}maxImages={1}- onSelect={({ urls }) => setSwapImageUrl(urls[0] || null)}- onClear={() => setSwapImageUrl(null)}- initialUrls={swapImageUrl ? [swapImageUrl] : []}- label="Swap Face"+ onSelect={({ urls }) => {+ setAuxiliaryImageUrls((current) => ({+ ...current,+ [field]: urls[0],+ }));+ }}+ onClear={() => {+ setAuxiliaryImageUrls((current) => {+ if (!Object.hasOwn(current, field)) return current;+ const next = { ...current };+ delete next[field];+ return next;+ });+ }}+ initialUrls={auxiliaryImageUrls[field] ? [auxiliaryImageUrls[field]] : []}+ label={label}/>- )}+ ))}</div>{/* Input prompt text area */}diff --git a/packages/studio/src/imageInputContracts.js b/packages/studio/src/imageInputContracts.jsnew file mode 100644index 00000000..5c110638--- /dev/null+++ b/packages/studio/src/imageInputContracts.js@@ -0,0 +1,137 @@+const BASE_CONTRACT = Object.freeze({+ primaryImageRequired: false,+ primaryImageLabel: "Reference image",+ promptField: "prompt",+ promptRequired: false,+ promptPlaceholder: "Describe how to transform this image (optional)",+ auxiliaryImages: Object.freeze([]),+});++const requiredImage = (field, label) => Object.freeze({+ field,+ label,+ required: true,+});++const hasText = (value) => typeof value === "string" && value.trim().length > 0;++export function normalizePrimaryImageUrls(imagesList, imageUrl) {+ const validImages = Array.isArray(imagesList) ? imagesList.filter(hasText) : [];+ if (validImages.length > 0) return validImages;+ return hasText(imageUrl) ? [imageUrl] : [];+}++const CONTRACTS = Object.freeze({+ "t2i:flux-pulid": Object.freeze({+ primaryImageRequired: true,+ promptRequired: true,+ }),+ "i2i:flux-pulid": Object.freeze({ promptRequired: true }),+ "t2i:flux-redux": Object.freeze({+ primaryImageRequired: true,+ promptRequired: true,+ }),+ "i2i:flux-redux": Object.freeze({ promptRequired: true }),+ "i2i:ai-dress-change": Object.freeze({+ primaryImageLabel: "Model image",+ auxiliaryImages: Object.freeze([+ requiredImage("garment_image_url", "Garment image"),+ ]),+ }),+ "i2i:ai-product-shot": Object.freeze({+ primaryImageLabel: "Product image",+ promptField: "scene_description",+ promptRequired: true,+ promptPlaceholder: "Describe the product scene",+ }),+ "i2i:ai-object-eraser": Object.freeze({+ primaryImageLabel: "Source image",+ auxiliaryImages: Object.freeze([+ requiredImage("mask_image_url", "Mask image"),+ ]),+ }),+ "i2i:gpt4o-edit": Object.freeze({+ primaryImageLabel: "Source image",+ promptRequired: true,+ promptPlaceholder: "Describe how to edit the image",+ auxiliaryImages: Object.freeze([+ requiredImage("mask_image_url", "Mask image"),+ ]),+ }),+ "i2i:add-image-watermark": Object.freeze({+ primaryImageLabel: "Source image",+ auxiliaryImages: Object.freeze([+ requiredImage("watermark_image_url", "Watermark image"),+ ]),+ }),+});++export function getImageInputContract(model, mode) {+ const contractKey = `${mode}:${model?.id}`;+ const patch = Object.hasOwn(CONTRACTS, contractKey)+ ? CONTRACTS[contractKey]+ : {};+ const isTextToImage = mode === "t2i";+ const promptRequired = patch.promptRequired ?? isTextToImage;+ return {+ ...BASE_CONTRACT,+ primaryImageRequired: mode === "i2i" || BASE_CONTRACT.primaryImageRequired,+ promptRequired,+ promptPlaceholder: promptRequired+ ? isTextToImage+ ? "Describe the image you want to create"+ : "Describe how to transform this image"+ : BASE_CONTRACT.promptPlaceholder,+ ...patch,+ auxiliaryImages: patch.auxiliaryImages || BASE_CONTRACT.auxiliaryImages,+ };+}++export function getAuxiliaryImageInputs(model, mode) {+ const configured = getImageInputContract(model, mode).auxiliaryImages;+ if (!model?.swapField || configured.some(({ field }) => field === model.swapField)) {+ return configured;+ }+ return [+ requiredImage(model.swapField, "Swap face image"),+ ...configured,+ ];+}++export function getImageInputValidationError(+ model,+ mode,+ {+ prompt = "",+ primaryImageUrls = [],+ auxiliaryImageUrls = {},+ } = {},+) {+ const contract = getImageInputContract(model, mode);+ if (contract.primaryImageRequired && !primaryImageUrls.some(hasText)) {+ return `Please upload a ${contract.primaryImageLabel.toLowerCase()}.`;+ }+ if (contract.promptRequired && !hasText(prompt)) {+ return contract.promptField === "scene_description"+ ? "Please enter a scene description."+ : "Please enter a prompt.";+ }+ const missingImage = getAuxiliaryImageInputs(model, mode).find(+ ({ field, required }) => required && !hasText(auxiliaryImageUrls[field]),+ );+ return missingImage+ ? `Please upload a ${missingImage.label.toLowerCase()}.`+ : null;+}++export function buildImageInputPayload(model, mode, params = {}) {+ const contract = getImageInputContract(model, mode);+ const payload = {};+ if (hasText(params.prompt)) {+ payload[contract.promptField] = params.prompt;+ }+ for (const { field } of getAuxiliaryImageInputs(model, mode)) {+ if (hasText(params[field])) payload[field] = params[field];+ }+ return payload;+}diff --git a/packages/studio/src/muapi.js b/packages/studio/src/muapi.jsindex 1bef9fec..8010f6c2 100644--- a/packages/studio/src/muapi.js+++ b/packages/studio/src/muapi.js@@ -1,4 +1,5 @@import { getModelById, getVideoModelById, getI2IModelById, getI2VModelById, getV2VModelById, getRecastModelById, getLipSyncModelById, getAudioModelById } from './models.js';+import { buildImageInputPayload, getImageInputValidationError, normalizePrimaryImageUrls } from './imageInputContracts.js';// In an http(s) browser we route through the host app's proxy (Next.js routes// under /api/* re-issue the call server-side) so api.muapi.ai CORS is bypassed.@@ -82,17 +83,19 @@ export async function generateImage(apiKey, params) {export async function generateI2I(apiKey, params) {const modelInfo = getI2IModelById(params.model);const endpoint = modelInfo?.endpoint || params.model;- const payload = {};- if (params.prompt) payload.prompt = params.prompt;const imageField = modelInfo?.imageField || 'image_url';- const imagesList = params.images_list?.length > 0 ? params.images_list : (params.image_url ? [params.image_url] : null);- if (imagesList) {+ const imagesList = normalizePrimaryImageUrls(params.images_list, params.image_url);+ const inputError = getImageInputValidationError(modelInfo, 'i2i', {+ prompt: params.prompt,+ primaryImageUrls: imagesList,+ auxiliaryImageUrls: params,+ });+ if (inputError) throw new Error(inputError);+ const payload = buildImageInputPayload(modelInfo, 'i2i', params);+ if (imagesList.length > 0) {if (imageField === 'images_list') payload.images_list = imagesList;else payload[imageField] = imagesList[0];}- if (modelInfo?.swapField && params.swap_url) {- payload[modelInfo.swapField] = params.swap_url;- }if (params.aspect_ratio) payload.aspect_ratio = params.aspect_ratio;if (params.resolution) payload.resolution = params.resolution;if (params.quality) payload.quality = params.quality;@@ -916,5 +919,3 @@ export async function expandImage(apiKey, { image_url, onRequestId }) {const payload = { image_url };return submitAndPoll(endpoint, payload, apiKey, onRequestId, 90);}--