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
{
///
/// fal.ai image provider via the queue API. Submits to queue.fal.run/{model} (auth header
/// "Authorization: Key <key>"), polls the request's status_url, then fetches the result and
/// returns the first image URL for the job manager to download.
///
public sealed class FalAdapter : IImageProviderAdapter
{
private const string QueueBase = "https://queue.fal.run/";
// FLUX.2 [dev] — current SOTA default (cheaper and better than FLUX.1 dev). Alternatives:
// fal-ai/flux-2/flash (fastest/cheapest), fal-ai/flux-2-pro (top quality).
private const string DefaultModel = "fal-ai/flux-2";
public string Id => "fal";
public async Task 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;
bool image = string.Equals(req.Mode, "image", StringComparison.OrdinalIgnoreCase)
&& (!string.IsNullOrEmpty(req.ImageUrl) || !string.IsNullOrEmpty(req.ImagePath));
var body = new JObject { ["prompt"] = req.Prompt ?? string.Empty, ["num_images"] = 1 };
string url;
if (image)
{
// image→image / editing lives on the model's /edit endpoint and takes an image_urls
// array; each entry accepts a hosted URL or an inline base64 data URI (local image_path).
url = QueueBase + model + "/edit";
string imageRef = !string.IsNullOrEmpty(req.ImageUrl) ? req.ImageUrl : LocalImage.ToDataUri(req.ImagePath);
body["image_urls"] = new JArray(imageRef);
}
else
{
url = QueueBase + model;
}
// Forward explicit output dimensions for text→image only; fal's image_size accepts a
// {width,height} object. (/edit derives size from the source image and may reject it.
// FLUX has no transparency param — transparent backgrounds aren't a generation-time option.)
if (!image && req.Width > 0 && req.Height > 0)
body["image_size"] = new JObject { ["width"] = req.Width, ["height"] = req.Height };
var spec = new HttpRequestSpec
{
Method = "POST",
Url = url,
ContentType = "application/json",
Body = Encoding.UTF8.GetBytes(body.ToString(Formatting.None))
};
spec.Headers["Authorization"] = "Key " + apiKey;
HttpResult res = await http.SendAsync(spec, ct);
JObject json = ParseOk(res, apiKey, "submit");
// Prefer response_url; fall back to building it from request_id.
string responseUrl = json["response_url"]?.ToString();
if (string.IsNullOrEmpty(responseUrl))
{
string requestId = json["request_id"]?.ToString();
if (string.IsNullOrEmpty(requestId))
throw new Exception(SecretRedactor.Scrub("fal submit returned no request_id: " + ProviderHttp.Truncate(res?.Text), apiKey));
// Queue request URLs are namespaced by owner/app without the action sub-path,
// so build from the base model id (not `url`, which may end in /edit).
responseUrl = QueueBase + model + "/requests/" + requestId;
}
return responseUrl;
}
public async Task PollAsync(string providerJobId, string apiKey, IHttpTransport http, CancellationToken ct)
{
if (string.IsNullOrEmpty(providerJobId)) throw new ArgumentNullException(nameof(providerJobId));
string responseUrl = providerJobId;
var statusSpec = new HttpRequestSpec { Method = "GET", Url = responseUrl + "/status" };
statusSpec.Headers["Authorization"] = "Key " + apiKey;
HttpResult statusRes = await http.SendAsync(statusSpec, ct);
JObject statusJson = ParseOk(statusRes, apiKey, "status");
string status = (statusJson["status"]?.ToString() ?? string.Empty).ToUpperInvariant();
var result = new ProviderPollResult();
switch (status)
{
case "COMPLETED":
case "OK":
result.State = ProviderPollState.Succeeded;
break;
case "IN_PROGRESS":
result.State = ProviderPollState.Running;
return result;
case "IN_QUEUE":
result.State = ProviderPollState.Queued;
return result;
case "ERROR":
case "FAILED":
result.State = ProviderPollState.Failed;
result.Error = SecretRedactor.Scrub(statusJson["error"]?.ToString() ?? "fal task failed.", apiKey);
return result;
default:
result.State = ProviderPollState.Running;
return result;
}
// Completed: fetch the result payload and extract the first image URL.
var resultSpec = new HttpRequestSpec { Method = "GET", Url = responseUrl };
resultSpec.Headers["Authorization"] = "Key " + apiKey;
HttpResult resultRes = await http.SendAsync(resultSpec, ct);
JObject resultJson = ParseOk(resultRes, apiKey, "result");
result.Progress = 1f;
result.DownloadUrl = ExtractImageUrl(resultJson);
if (string.IsNullOrEmpty(result.DownloadUrl))
{
result.State = ProviderPollState.Failed;
result.Error = "fal completed but no image URL was present in the result.";
}
return result;
}
private static string ExtractImageUrl(JObject result)
{
JToken images = result["images"];
if (images is JArray arr && arr.Count > 0)
{
string u = arr[0]?["url"]?.ToString();
if (!string.IsNullOrEmpty(u)) return u;
}
string single = result["image"]?["url"]?.ToString();
return string.IsNullOrEmpty(single) ? null : single;
}
private static JObject ParseOk(HttpResult res, string apiKey, string phase)
{
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;
if (!ok)
{
string detail = json?["detail"]?.ToString() ?? json?["error"]?.ToString() ?? ProviderHttp.Truncate(text);
throw new Exception(SecretRedactor.Scrub($"fal {phase} failed (status={res?.Status}): {detail}", apiKey));
}
return json ?? new JObject();
}
}
}