feat(asset-gen): register MiniMax image provider in the image tool chain

Add MiniMaxImageAdapter (synchronous /v1/image_generation endpoint, Bearer
auth) for text->image and image->image (subject_reference) generation, and
register the minimax provider across the adapter factory, model catalog,
secure-store id list, GUI panel, and Python tool/CLI surface.

Author: octo-patch

MCPForUnity/Editor/Security/SecureKeyStore/SecureKeyStoreConstants.cs

@@ -9,7 +9,7 @@ internal static class SecureKeyStoreConstants
         /// <summary>Known asset-generation provider ids (lowercase).</summary>
         internal static readonly string[] ProviderIds =
         {
-            "tripo", "meshy", "sketchfab", "fal", "openrouter"
+            "tripo", "meshy", "sketchfab", "fal", "openrouter", "minimax"
         };
     }
 }

MCPForUnity/Editor/Services/AssetGen/AssetGenModelCatalog.cs

@@ -53,6 +53,10 @@ public static class AssetGenModelCatalog
             // Image — openrouter
             new ModelEntry { Id = OpenRouterAdapter.DefaultModel, Label = "Gemini 2.5 Flash Image", Provider = "openrouter", Kind = "image", UseCase = "General image" },
 
+            // Image — minimax (MiniMaxImageAdapter.DefaultModel is first => the default)
+            new ModelEntry { Id = MiniMaxImageAdapter.DefaultModel, Label = "MiniMax image-01", Provider = "minimax", Kind = "image", UseCase = "General image" },
+            new ModelEntry { Id = "image-01-live", Label = "MiniMax image-01-live", Provider = "minimax", Kind = "image", UseCase = "Live image" },
+
             // 3D — tripo / meshy (defaults reference the adapter constants)
             new ModelEntry { Id = TripoAdapter.ModelVersion, Label = "Tripo v3.1", Provider = "tripo", Kind = "model", UseCase = "Text / image -> 3D" },
             new ModelEntry { Id = "P1-20260311", Label = "Tripo P1 (premium)", Provider = "tripo", Kind = "model", UseCase = "Premium 3D" },

MCPForUnity/Editor/Services/AssetGen/Providers/AssetGenProviders.cs

@@ -33,6 +33,8 @@ public static IImageProviderAdapter Image(string id)
                     return new FalAdapter();
                 case "openrouter":
                     return new OpenRouterAdapter();
+                case "minimax":
+                    return new MiniMaxImageAdapter();
                 default:
                     throw new NotSupportedException($"Unknown image provider '{id}'.");
             }
@@ -69,6 +71,7 @@ public static IReadOnlyList<ProviderInfo> List()
                 new ProviderInfo { Id = "sketchfab", Kind = "marketplace", Configured = IsConfigured("sketchfab"), Capabilities = new[] { "search", "import" } },
                 new ProviderInfo { Id = "fal", Kind = "image", Configured = IsConfigured("fal"), Capabilities = new[] { "text", "image" } },
                 new ProviderInfo { Id = "openrouter", Kind = "image", Configured = IsConfigured("openrouter"), Capabilities = new[] { "text", "image" } },
+                new ProviderInfo { Id = "minimax", Kind = "image", Configured = IsConfigured("minimax"), Capabilities = new[] { "text", "image" } },
                 // fal appears twice by design — once per kind (image + audio) — sharing the single "fal" key.
                 new ProviderInfo { Id = "fal", Kind = "audio", Configured = IsConfigured("fal"), Capabilities = new[] { "text", "music", "sfx" } },
             };

MCPForUnity/Editor/Services/AssetGen/Providers/MiniMaxImageAdapter.cs

@@ -0,0 +1,155 @@
+using System;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+using MCPForUnity.Editor.Security;
+using MCPForUnity.Editor.Services.AssetGen.Http;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+
+namespace MCPForUnity.Editor.Services.AssetGen.Providers
+{
+    /// <summary>
+    /// MiniMax 2D image provider via the synchronous <c>/v1/image_generation</c> endpoint. Text→image
+    /// submits a prompt; image→image attaches a <c>subject_reference</c> entry whose
+    /// <c>image_file</c> accepts a hosted URL or an inline base64 data URI (for a local image_path).
+    /// The image is returned inline (base64) or as a URL the job manager downloads, so all work
+    /// happens in <see cref="SubmitAsync"/> and <see cref="PollAsync"/> returns the captured result
+    /// immediately. One adapter instance handles a single job (the job manager captures it for
+    /// submit+poll).
+    /// </summary>
+    public sealed class MiniMaxImageAdapter : IImageProviderAdapter
+    {
+        private const string Endpoint = "https://api.minimax.io/v1/image_generation";
+        private const string AllowedHost = "api.minimax.io";
+        // internal so the model catalog references it directly (single source of truth, drift-guarded).
+        internal const string DefaultModel = "image-01";
+
+        public string Id => "minimax";
+
+        private byte[] _inlineData;
+        private string _downloadUrl;
+        private string _error;
+
+        public async Task<string> SubmitAsync(ImageGenRequest req, string apiKey, IHttpTransport http, CancellationToken ct)
+        {
+            if (req == null) throw new ArgumentNullException(nameof(req));
+            if (http == null) throw new ArgumentNullException(nameof(http));
+
+            string model = string.IsNullOrEmpty(req.Model) ? DefaultModel : req.Model;
+
+            var body = new JObject
+            {
+                ["model"] = model,
+                ["prompt"] = req.Prompt ?? string.Empty
+            };
+
+            // image→image: attach the reference image as a subject_reference entry. image_file
+            // accepts a hosted URL or an inline base64 data URI (for a local image_path). Plain
+            // text→image sends prompt only.
+            bool image = string.Equals(req.Mode, "image", StringComparison.OrdinalIgnoreCase)
+                         && (!string.IsNullOrEmpty(req.ImageUrl) || !string.IsNullOrEmpty(req.ImagePath));
+            if (image)
+            {
+                string imageRef = !string.IsNullOrEmpty(req.ImageUrl) ? req.ImageUrl : LocalImage.ToDataUri(req.ImagePath);
+                body["subject_reference"] = new JArray(
+                    new JObject { ["type"] = "character", ["image_file"] = imageRef });
+            }
+
+            // Forward explicit output dimensions for text→image only; the provider accepts a
+            // {width,height} pair. (image→image derives size from the subject reference.)
+            if (!image && req.Width > 0 && req.Height > 0)
+            {
+                body["width"] = req.Width;
+                body["height"] = req.Height;
+            }
+
+            // The endpoint is a compile-time constant; re-validate before attaching the key so a
+            // future change can never route credentials to an unexpected host.
+            ProviderHttp.RequireHost(Endpoint, AllowedHost, apiKey, "minimax submit");
+
+            var spec = new HttpRequestSpec
+            {
+                Method = "POST",
+                Url = Endpoint,
+                ContentType = "application/json",
+                Body = Encoding.UTF8.GetBytes(body.ToString(Formatting.None))
+            };
+            spec.Headers["Authorization"] = "Bearer " + apiKey;
+
+            HttpResult res = await http.SendAsync(spec, ct);
+            JObject json = ParseOk(res, apiKey);
+
+            // Prefer a URL result (default response_format=url); fall back to inline base64.
+            string url = ExtractImageUrl(json);
+            if (!string.IsNullOrEmpty(url))
+            {
+                _downloadUrl = url;
+            }
+            else
+            {
+                string b64 = ExtractImageBase64(json);
+                if (!string.IsNullOrEmpty(b64))
+                {
+                    try { _inlineData = Convert.FromBase64String(b64); }
+                    catch { _error = "MiniMax returned an image payload that was not valid base64."; }
+                }
+                else
+                {
+                    _error = "MiniMax returned no image. The selected model may not support image output.";
+                }
+            }
+            return "ready";
+        }
+
+        public Task<ProviderPollResult> PollAsync(string providerJobId, string apiKey, IHttpTransport http, CancellationToken ct)
+        {
+            var result = new ProviderPollResult { Progress = 1f };
+            if (!string.IsNullOrEmpty(_error) || (_inlineData == null && string.IsNullOrEmpty(_downloadUrl)))
+            {
+                result.State = ProviderPollState.Failed;
+                result.Error = _error ?? "MiniMax produced no image.";
+            }
+            else
+            {
+                result.State = ProviderPollState.Succeeded;
+                result.InlineData = _inlineData;
+                result.DownloadUrl = _downloadUrl;
+            }
+            return Task.FromResult(result);
+        }
+
+        private static string ExtractImageUrl(JObject json)
+            => (json["data"]?["image_urls"] as JArray)?[0]?.ToString();
+
+        private static string ExtractImageBase64(JObject json)
+            => (json["data"]?["image_base64"] as JArray)?[0]?.ToString();
+
+        private static JObject ParseOk(HttpResult res, string apiKey)
+        {
+            string text = ProviderHttp.BodyText(res);
+
+            JObject json = null;
+            if (!string.IsNullOrEmpty(text))
+            {
+                try { json = JObject.Parse(text); } catch { /* non-JSON */ }
+            }
+
+            bool ok = res?.Ok == true;
+            // MiniMax signals failure with a non-zero base_resp.status_code even on HTTP 200.
+            int status = json?["base_resp"]?["status_code"]?.Type == JTokenType.Integer
+                ? (int)json["base_resp"]["status_code"]
+                : 0;
+            if (!ok || status != 0)
+            {
+                string detail = json?["base_resp"]?["status_msg"]?.ToString()
+                                ?? json?["error"]?["message"]?.ToString()
+                                ?? json?["error"]?.ToString()
+                                ?? ProviderHttp.Truncate(text);
+                throw new Exception(SecretRedactor.Scrub(
+                    $"MiniMax request failed (status={res?.Status}, base_resp.status_code={status}): {detail}", apiKey));
+            }
+            return json ?? new JObject();
+        }
+    }
+}

MCPForUnity/Editor/Services/AssetGen/Providers/MiniMaxImageAdapter.cs.meta

@@ -34,6 +34,7 @@ private static readonly (string Id, string Label)[] ImageProviders =
         {
             ("fal", "fal"),
             ("openrouter", "OpenRouter"),
+            ("minimax", "MiniMax"),
         };
 
         // UI Elements

MCPForUnity/Editor/Windows/Components/AssetGen/McpAssetGenSection.cs

@@ -146,7 +146,7 @@ def import_model_file(source_path, name, output_folder, target_size, animation_t
 
 
 @asset_gen.command("generate-image")
-@click.option("--provider", default=None, help="Provider id (fal, openrouter).")
+@click.option("--provider", default=None, help="Provider id (fal, openrouter, minimax).")
 @click.option("--mode", default=None, help="Generation mode: text or image.")
 @click.option("--prompt", default=None, help="Text prompt for text->image.")
 @click.option("--image-path", default=None, help="Source image path for image->image.")

Server/src/cli/commands/asset_gen.py

@@ -19,7 +19,7 @@
 @mcp_for_unity_tool(
     group="asset_gen",
     description=(
-        "Generate 2D images with AI providers (fal.ai, OpenRouter) and import them as "
+        "Generate 2D images with AI providers (fal.ai, OpenRouter, MiniMax) and import them as "
         "textures/sprites into the Unity project. Bring-your-own-key: provider keys live "
         "in the editor's secure store and never cross the bridge.\n\n"
         "ACTIONS:\n"
@@ -42,7 +42,7 @@ async def generate_image(
     action: Annotated[Literal["generate", "remove_background", "status", "cancel", "list_providers"],
                       "Action to perform."],
 
-    provider: Annotated[str, "Provider id (fal, openrouter)."] | None = None,
+    provider: Annotated[str, "Provider id (fal, openrouter, minimax)."] | None = None,
     mode: Annotated[str, "Generation mode: text or image."] | None = None,
     prompt: Annotated[str, "Text prompt for text->image."] | None = None,
     image_path: Annotated[str, "Path to a source image for image->image mode."] | None = None,

Server/src/services/tools/generate_image.py

@@ -67,6 +67,7 @@ public void DefaultModelId_PerKindPerProvider()
             Assert.AreEqual("fal-ai/stable-audio-25/text-to-audio", AssetGenModelCatalog.DefaultModelId("fal", "audio"));
             Assert.AreEqual("v3.1-20260211", AssetGenModelCatalog.DefaultModelId("tripo", "model"));
             Assert.AreEqual("meshy-6", AssetGenModelCatalog.DefaultModelId("meshy", "model"));
+            Assert.AreEqual("image-01", AssetGenModelCatalog.DefaultModelId("minimax", "image"));
             Assert.IsNull(AssetGenModelCatalog.DefaultModelId("nope", "audio"), "unknown provider => null, not a throw");
         }
 
@@ -80,6 +81,7 @@ public void DefaultModelId_MatchesAdapterConstants()
             Assert.AreEqual(MeshyAdapter.DefaultModel, AssetGenModelCatalog.DefaultModelId("meshy", "model"));
             Assert.AreEqual(FalAdapter.DefaultModel, AssetGenModelCatalog.DefaultModelId("fal", "image"));
             Assert.AreEqual(FalAudioAdapter.DefaultModel, AssetGenModelCatalog.DefaultModelId("fal", "audio"));
+            Assert.AreEqual(MiniMaxImageAdapter.DefaultModel, AssetGenModelCatalog.DefaultModelId("minimax", "image"));
         }
 
         [Test]
@@ -90,5 +92,16 @@ public void Find_ReturnsEntry_ByExactId()
             Assert.AreEqual("audio", e.Kind);
             Assert.IsNull(AssetGenModelCatalog.Find("does/not/exist"));
         }
+
+        [Test]
+        public void Curated_HasMiniMaxImageModels()
+        {
+            IReadOnlyList<ModelEntry> image = AssetGenModelCatalog.ForProvider("minimax", "image");
+
+            CollectionAssert.AreEqual(
+                new[] { "image-01", "image-01-live" },
+                image.Select(e => e.Id).ToList());
+            Assert.AreEqual("image", image[0].Kind);
+        }
     }
 }

TestProjects/UnityMCPTests/Assets/Tests/EditMode/AssetGen/AssetGenModelCatalogTests.cs

@@ -35,6 +35,14 @@ public void Audio_Fal_ReturnsAdapter()
             Assert.AreEqual("fal", adapter.Id);
         }
 
+        [Test]
+        public void Image_MiniMax_ReturnsAdapter()
+        {
+            IImageProviderAdapter adapter = AssetGenProviders.Image("minimax");
+            Assert.IsNotNull(adapter);
+            Assert.AreEqual("minimax", adapter.Id);
+        }
+
         [Test]
         public void Audio_Unimplemented_Throws()
         {