@howells/motif-sdk 5.1.1 → 5.3.0

package/dist/index.js

@@ -706,14 +706,31 @@ function getOpenAiKeyFromEnv(input = process.env) {
 }
 //#endregion
 //#region src/models.ts
-const AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-08-23";
+const AA_IMAGE_LEADERBOARD_SNAPSHOT = "2026-10-07";
 const AA_IMAGE_SOURCES = ["https://artificialanalysis.ai/image/leaderboard/text-to-image", "https://artificialanalysis.ai/image/leaderboard/editing"];
 const FAL_PRICING_CHECKED_AT = "2026-05-12";
 const FAL_PRICING_CHECKED_JUL_2026 = "2026-07-11";
 const FAL_PRICING_CHECKED_AUG_2026 = "2026-08-23";
 const FAL_PRICING_CHECKED_SEP_2026 = "2026-09-16";
+const FAL_PRICING_CHECKED_OCT_2026 = "2026-10-29";
 const MODELS = {
 	flare: {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1163,
+					rank: 2
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1191,
+					rank: 2
+				}
+			},
+			useCase: "Frontier generation and editing, evaluated at max quality"
+		},
+		defaultQuality: "max",
 		customImageSize: {
 			maxEdge: 3840,
 			maxPixels: 8294400,
@@ -750,6 +767,22 @@ const MODELS = {
 		useQueue: true
 	},
 	sunburst: {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1183,
+					rank: 1
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1198,
+					rank: 1
+				}
+			},
+			useCase: "Frontier generation and editing, evaluated at max quality"
+		},
+		defaultQuality: "max",
 		customImageSize: {
 			maxEdge: 3840,
 			maxPixels: 8294400,
@@ -789,14 +822,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1256,
-					rank: 3
+					elo: 1125,
+					rank: 5
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1369,
-					rank: 1
+					elo: 1172,
+					rank: 3
 				}
 			},
 			speed: {
@@ -809,7 +842,7 @@ const MODELS = {
 				quality: "frontier",
 				speed: "very_slow"
 			},
-			useCase: "Highest-ranked text-to-image quality and transparent PNGs"
+			useCase: "Established frontier generation and transparent PNGs"
 		},
 		customImageSize: {
 			maxEdge: 3840,
@@ -860,14 +893,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1250,
-					rank: 5
+					elo: 1103,
+					rank: 12
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1310,
-					rank: 4
+					elo: 1107,
+					rank: 8
 				}
 			},
 			speed: {
@@ -880,7 +913,7 @@ const MODELS = {
 				quality: "frontier",
 				speed: "slow"
 			},
-			useCase: "Best OpenAI edit quality with transparent PNG support"
+			useCase: "Established OpenAI editor with transparent PNG support"
 		},
 		editEndpoint: "fal-ai/gpt-image-1.5/edit",
 		endpoint: "fal-ai/gpt-image-1.5",
@@ -913,18 +946,103 @@ const MODELS = {
 		supportsSyncMode: true,
 		type: "generation"
 	},
-	banana2: {
+	banana21: {
+		benchmark: { useCase: "Efficient generation and reference editing; Arena #5 generation / #6 editing, preliminary 2026-10-06" },
+		editEndpoint: "google/nano-banana-2.1/edit",
+		endpoint: "google/nano-banana-2.1",
+		maxReferenceImages: 14,
+		name: "Nano Banana 2.1",
+		pricePerImageUsd: null,
+		pricing: "Token-based: input $1.764/M, text/thinking output $8.823/M, image output $35.294/M; ~ $0.040 / $0.059 / $0.134 at 1K / 2K / 4K plus variable usage",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"auto",
+			"21:9",
+			"16:9",
+			"3:2",
+			"4:3",
+			"5:4",
+			"1:1",
+			"4:5",
+			"3:4",
+			"2:3",
+			"9:16",
+			"4:1",
+			"1:4",
+			"8:1",
+			"1:8"
+		],
+		supportedResolutions: [
+			"1K",
+			"2K",
+			"4K"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsLimitGenerations: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: true,
+		supportsSafetyTolerance: true,
+		supportsSeed: true,
+		supportsSyncMode: true,
+		supportsThinkingLevel: true,
+		supportsWebSearch: true,
+		type: "generation"
+	},
+	"mai-image-2.5": {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1249,
+					elo: 1114,
 					rank: 7
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1320,
-					rank: 3
+					elo: 1104,
+					rank: 10
+				}
+			},
+			useCase: "Strong single-reference editing at a lower price than MAI 2.5 Pro"
+		},
+		editEndpoint: "microsoft/mai-image-2.5/edit",
+		endpoint: "microsoft/mai-image-2.5",
+		maxReferenceImages: 1,
+		name: "MAI Image 2.5",
+		pricePerImageUsd: null,
+		pricing: "Token-based: text input $5/M, image input $8/M; ~$0.05 image output plus input",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"auto",
+			"1:1",
+			"4:3",
+			"3:4",
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	banana2: {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1110,
+					rank: 9
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1126,
+					rank: 6
 				}
 			},
 			tiers: {
@@ -932,7 +1050,7 @@ const MODELS = {
 				quality: "frontier",
 				speed: "unknown"
 			},
-			useCase: "Best balance of quality, edit support, web search, and cost"
+			useCase: "Previous-generation Gemini workhorse; retains 0.5K output"
 		},
 		editEndpoint: "fal-ai/nano-banana-2/edit",
 		endpoint: "fal-ai/nano-banana-2",
@@ -968,14 +1086,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1245,
-					rank: 9
+					elo: 1101,
+					rank: 13
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1297,
-					rank: 6
+					elo: 1102,
+					rank: 11
 				}
 			},
 			speed: {
@@ -1040,11 +1158,15 @@ const MODELS = {
 	gemini: {
 		benchmark: { artificialAnalysis: {
 			editing: {
-				elo: 1180,
-				rank: 29
+				elo: 987,
+				rank: 50
 			},
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-			sourceUrls: AA_IMAGE_SOURCES
+			sourceUrls: AA_IMAGE_SOURCES,
+			textToImage: {
+				elo: 985,
+				rank: 60
+			}
 		} },
 		editEndpoint: "fal-ai/gemini-25-flash-image/edit",
 		endpoint: "fal-ai/gemini-25-flash-image",
@@ -1085,18 +1207,6 @@ const MODELS = {
 		type: "generation"
 	},
 	gemini3: {
-		benchmark: { artificialAnalysis: {
-			editing: {
-				elo: 1245,
-				rank: 9
-			},
-			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-			sourceUrls: AA_IMAGE_SOURCES,
-			textToImage: {
-				elo: 1297,
-				rank: 6
-			}
-		} },
 		editEndpoint: "fal-ai/gemini-3-pro-image-preview/edit",
 		endpoint: "fal-ai/gemini-3-pro-image-preview",
 		falPricing: {
@@ -1146,14 +1256,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1185,
-					rank: 28
+					elo: 1015,
+					rank: 36
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1226,
-					rank: 16
+					elo: 1030,
+					rank: 21
 				}
 			},
 			speed: {
@@ -1166,7 +1276,7 @@ const MODELS = {
 				quality: "best",
 				speed: "balanced"
 			},
-			useCase: "High-ranked budget generation and large multi-reference edits"
+			useCase: "Legacy budget generation and large multi-reference edits"
 		},
 		customImageSize: {
 			maxPixels: 16777216,
@@ -1200,14 +1310,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1186,
-					rank: 26
+					elo: 1037,
+					rank: 32
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1203,
-					rank: 32
+					elo: 1022,
+					rank: 26
 				}
 			},
 			speed: {
@@ -1253,14 +1363,14 @@ const MODELS = {
 	seedream5: {
 		benchmark: { artificialAnalysis: {
 			editing: {
-				elo: 1248,
-				rank: 8
+				elo: 1108,
+				rank: 11
 			},
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES,
 			textToImage: {
-				elo: 1279,
-				rank: 10
+				elo: 1081,
+				rank: 15
 			}
 		} },
 		customImageSize: {
@@ -1295,11 +1405,15 @@ const MODELS = {
 	"seedream5-lite": {
 		benchmark: { artificialAnalysis: {
 			editing: {
-				elo: 1169,
-				rank: 32
+				elo: 1057,
+				rank: 24
 			},
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-			sourceUrls: AA_IMAGE_SOURCES
+			sourceUrls: AA_IMAGE_SOURCES,
+			textToImage: {
+				elo: 1012,
+				rank: 36
+			}
 		} },
 		customImageSize: {
 			maxPixels: 16777216,
@@ -1333,14 +1447,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1201,
-					rank: 19
+					elo: 997,
+					rank: 49
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1225,
-					rank: 17
+					elo: 1020,
+					rank: 28
 				}
 			},
 			speed: {
@@ -1392,14 +1506,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1170,
-					rank: 31
+					elo: 1007,
+					rank: 41
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1207,
-					rank: 30
+					elo: 1004,
+					rank: 41
 				}
 			},
 			speed: {
@@ -1450,11 +1564,15 @@ const MODELS = {
 	"flux2-flex": {
 		benchmark: {
 			artificialAnalysis: {
+				editing: {
+					elo: 1007,
+					rank: 42
+				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1223,
-					rank: 18
+					elo: 1027,
+					rank: 22
 				}
 			},
 			speed: {
@@ -1508,8 +1626,16 @@ const MODELS = {
 	"flux2-dev": {
 		benchmark: {
 			artificialAnalysis: {
+				editing: {
+					elo: 1e3,
+					rank: 45
+				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-				sourceUrls: AA_IMAGE_SOURCES
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1e3,
+					rank: 42
+				}
 			},
 			speed: {
 				medianSeconds: 4.6,
@@ -1672,24 +1798,12 @@ const MODELS = {
 	},
 	reve: {
 		benchmark: {
-			artificialAnalysis: {
-				editing: {
-					elo: 1263,
-					rank: 2
-				},
-				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-				sourceUrls: AA_IMAGE_SOURCES,
-				textToImage: {
-					elo: 1322,
-					rank: 2
-				}
-			},
 			tiers: {
 				price: "premium",
 				quality: "frontier",
 				speed: "unknown"
 			},
-			useCase: "Highest-ranked editor reachable on fal; strong prompt adherence and text rendering"
+			useCase: "Historical Reve route; not currently verified on fal"
 		},
 		editEndpoint: "fal-ai/reve/edit",
 		endpoint: "fal-ai/reve/text-to-image",
@@ -1730,8 +1844,8 @@ const MODELS = {
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES,
 			textToImage: {
-				elo: 1215,
-				rank: 25
+				elo: 984,
+				rank: 62
 			}
 		} },
 		customImageSize: {},
@@ -1789,8 +1903,8 @@ const MODELS = {
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES,
 			textToImage: {
-				elo: 1220,
-				rank: 19
+				elo: 1004,
+				rank: 40
 			}
 		} },
 		customImageSize: {
@@ -1828,14 +1942,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1214,
-					rank: 16
+					elo: 1073,
+					rank: 19
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1216,
-					rank: 23
+					elo: 1019,
+					rank: 30
 				}
 			},
 			speed: {
@@ -1888,7 +2002,11 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
-				sourceUrls: AA_IMAGE_SOURCES
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 890,
+					rank: 106
+				}
 			},
 			speed: {
 				medianSeconds: 23.3,
@@ -1930,14 +2048,14 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1218,
-					rank: 15
+					elo: 1056,
+					rank: 25
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1272,
-					rank: 11
+					elo: 1075,
+					rank: 16
 				}
 			},
 			tiers: {
@@ -1945,12 +2063,13 @@ const MODELS = {
 				quality: "better",
 				speed: "unknown"
 			},
-			useCase: "Strong quality per dollar - 11th on text-to-image at $30/1k"
+			useCase: "Strong generation with negative-prompt and seed controls"
 		},
 		customImageSize: {
 			maxPixels: 4194304,
 			minPixels: 262144
 		},
+		editEndpoint: "alibaba/qwen-image-3/edit",
 		endpoint: "alibaba/qwen-image-3/text-to-image",
 		falPricing: {
 			checkedAt: FAL_PRICING_CHECKED_SEP_2026,
@@ -1961,12 +2080,13 @@ const MODELS = {
 			unit: "images",
 			unitPrice: .04
 		},
+		maxReferenceImages: 3,
 		name: "Qwen Image 3",
 		pricePerImageUsd: .04,
 		pricing: "$0.04 (1K) / $0.075 (2K)",
 		sizeMode: "image_size_enum",
 		supportsAspect: true,
-		supportsEdit: false,
+		supportsEdit: true,
 		supportsNegativePrompt: true,
 		supportsNumImages: true,
 		supportsOutputFormat: true,
@@ -1979,17 +2099,17 @@ const MODELS = {
 		benchmark: {
 			artificialAnalysis: {
 				editing: {
-					elo: 1272,
-					rank: 1
+					elo: 1110,
+					rank: 10
 				},
 				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 				sourceUrls: AA_IMAGE_SOURCES,
 				textToImage: {
-					elo: 1293,
-					rank: 7
+					elo: 1100,
+					rank: 12
 				}
 			},
-			useCase: "Highest-ranked image editor, single reference image"
+			useCase: "Strong single-reference editor; MAI 2.5 ranks higher on the current editing board"
 		},
 		editEndpoint: "microsoft/mai-image-2.5-pro/edit",
 		editImagesField: "image_url",
@@ -2028,20 +2148,26 @@ const MODELS = {
 	},
 	"banana2-lite": {
 		benchmark: { artificialAnalysis: {
+			editing: {
+				elo: 1046,
+				rank: 26
+			},
 			snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
 			sourceUrls: AA_IMAGE_SOURCES,
 			textToImage: {
-				elo: 1289,
-				rank: 8
+				elo: 1095,
+				rank: 13
 			}
 		} },
+		editEndpoint: "google/nano-banana-2-lite/edit",
+		maxReferenceImages: 14,
 		endpoint: "google/nano-banana-2-lite",
 		name: "Nano Banana 2 Lite",
-		pricing: "Token-based: text $0.3125/M input, $1.875/M output; image $0.3125/M input, $37.50/M output; fixed 1K output (~$0.048)",
-		pricePerImageUsd: .048,
+		pricing: "Token-based: text $0.3125/M input, $1.875/M output; image $0.3125/M input, $37.50/M output; fixed 1K output (~$0.042 image output, plus input/thinking)",
+		pricePerImageUsd: null,
 		sizeMode: "aspect_ratio",
 		supportsAspect: true,
-		supportsEdit: false,
+		supportsEdit: true,
 		supportsLimitGenerations: true,
 		supportsNumImages: true,
 		supportsOutputFormat: true,
@@ -2114,6 +2240,21 @@ const MODELS = {
 		type: "generation"
 	},
 	"grok-image-2": {
+		benchmark: {
+			artificialAnalysis: {
+				editing: {
+					elo: 1110,
+					rank: 8
+				},
+				snapshotDate: AA_IMAGE_LEADERBOARD_SNAPSHOT,
+				sourceUrls: AA_IMAGE_SOURCES,
+				textToImage: {
+					elo: 1156,
+					rank: 4
+				}
+			},
+			useCase: "Strong generation and editing with predictable per-image billing"
+		},
 		editEndpoint: "xai/grok-imagine-image/v2.0/edit",
 		endpoint: "xai/grok-imagine-image/v2.0/text-to-image",
 		falPricing: {
@@ -2148,6 +2289,120 @@ const MODELS = {
 		supportsSyncMode: true,
 		type: "generation"
 	},
+	"muse-image": {
+		benchmark: { useCase: "Low-cost generation and multi-reference editing; Arena #8 generation / #10 editing, 2026-10-29" },
+		editEndpoint: "meta/muse-image/edit",
+		endpoint: "meta/muse-image/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "meta/muse-image/text-to-image",
+			estimatedCostPerImageUsd: .01,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .01
+		},
+		maxReferenceImages: 10,
+		name: "Meta Muse Image",
+		pricePerImageUsd: .01,
+		pricing: "$0.01",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"1:1",
+			"4:3",
+			"3:4",
+			"16:9",
+			"9:16",
+			"3:2",
+			"2:3",
+			"4:5",
+			"5:4",
+			"21:9",
+			"4:1",
+			"1:4",
+			"8:1",
+			"1:8"
+		],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	krea3: {
+		benchmark: { useCase: "Reference editing with prompt planning. Motif sends fal's defaults (berry, medium reasoning), which Arena has not scored; Arena's 1411 editing score (2026-10-29) is for Ultra, available with --param reasoning_level=ultra" },
+		customImageSize: {
+			maxEdge: 3200,
+			maxPixels: 4220160,
+			minEdge: 256,
+			multipleOf: 16
+		},
+		editEndpoint: "krea/v3/edit",
+		endpoint: "krea/v3/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "krea/v3/text-to-image",
+			estimatedCostPerImageUsd: .025,
+			source: "fal-pricing-api",
+			unit: "megapixels",
+			unitPrice: .025
+		},
+		maxReferenceImages: 8,
+		name: "Krea 3",
+		pricePerImageUsd: .025,
+		pricing: "$0.025/MP (edits also bill each reference)",
+		sizeMode: "image_size_enum",
+		supportedOutputFormats: ["png", "jpeg"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNegativePrompt: true,
+		supportsNumImages: false,
+		supportsOutputFormat: true,
+		supportsResolution: false,
+		supportsSafetyChecker: true,
+		supportsSeed: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
+	"grok-image-quality": {
+		benchmark: { useCase: "Detailed generation and editing with stronger text rendering; Arena #11 editing, 2026-10-29" },
+		editEndpoint: "xai/grok-imagine-image/quality/edit",
+		endpoint: "xai/grok-imagine-image/quality/text-to-image",
+		falPricing: {
+			checkedAt: FAL_PRICING_CHECKED_OCT_2026,
+			currency: "USD",
+			endpointId: "xai/grok-imagine-image/quality/text-to-image",
+			estimatedCostPerImageUsd: .05,
+			source: "fal-pricing-api",
+			unit: "images",
+			unitPrice: .05
+		},
+		maxReferenceImages: 3,
+		name: "Grok Imagine Image Quality",
+		pricePerImageUsd: .05,
+		pricing: "$0.05 (1K) / $0.07 (2K)",
+		sizeMode: "aspect_ratio",
+		supportedAspects: [
+			"16:9",
+			"4:3",
+			"3:2",
+			"1:1",
+			"2:3",
+			"3:4",
+			"9:16"
+		],
+		supportedResolutions: ["1K", "2K"],
+		supportsAspect: true,
+		supportsEdit: true,
+		supportsNumImages: true,
+		supportsOutputFormat: true,
+		supportsResolution: true,
+		supportsSyncMode: true,
+		type: "generation"
+	},
 	kling: {
 		endpoint: "fal-ai/kling-video/v3/pro/image-to-video",
 		name: "Kling v3 Pro",
@@ -2211,38 +2466,47 @@ const MODELS = {
 		type: "utility"
 	}
 };
+/** Curated generation choices; predecessor routes are explicit-only. */
 const GENERATION_MODELS = [
-	"flare",
 	"sunburst",
+	"flare",
 	"gpt2",
 	"gpt",
+	"banana21",
 	"banana2",
 	"banana",
+	"mai-image-2.5",
+	"mai-image-2.5-pro",
+	"seedream5",
+	"qwen3",
+	"banana2-lite",
+	"grok-image-2",
+	"grok-image-quality",
+	"grok-image",
+	"muse-image",
+	"krea3",
+	"flux2-flex",
+	"flux2-pro",
+	"flux2-turbo",
+	"seedream5-lite",
+	"ideogram4",
+	"ideogram3-transparent",
+	"recraft41"
+];
+/** Retained for old pins, explicit overrides and tuned Looks, never auto-selected. */
+const LEGACY_GENERATION_MODELS = [
 	"gemini",
 	"gemini3",
 	"seedream4",
 	"seedream45",
-	"seedream5",
-	"seedream5-lite",
 	"flux2-max",
-	"flux2-pro",
-	"flux2-flex",
 	"flux2-dev",
-	"flux2-turbo",
 	"flux",
 	"flux-fast",
 	"recraft",
 	"recraft4",
 	"ideogram",
-	"ideogram4",
-	"grok-image",
-	"grok-image-2",
-	"qwen",
-	"qwen3",
-	"mai-image-2.5-pro",
-	"banana2-lite",
-	"ideogram3-transparent",
-	"recraft41"
+	"qwen"
 ];
 GENERATION_MODELS.filter((id) => MODELS[id]?.supportsEdit === true);
 const UTILITY_MODELS = [
@@ -2262,6 +2526,7 @@ function estimateCost(model, resolution, numImages = 1, editImages = 0) {
 	if (configuredPrice === null) return null;
 	if (model === "mai-image-2.5-pro" && editImages > 0) return .27 * numImages;
 	if (model === "grok-image-2" && editImages > 0) return (resolution === "2K" || resolution === "4K" ? .08 : .06) * numImages + .01 * editImages;
+	if (model === "grok-image-quality") return (resolution === "2K" || resolution === "4K" ? .07 : .05) * numImages + .01 * editImages;
 	if (configuredPrice !== void 0) {
 		if ((model === "banana" || model === "gemini3") && resolution === "4K") return configuredPrice * 2 * numImages;
 		if (model === "seedream5" && (resolution === "2K" || resolution === "4K")) return configuredPrice * 2 * numImages;
@@ -2617,9 +2882,9 @@ function buildGenerateBody(options) {
 			break;
 		case "aspect_ratio":
 			if (config.supportsAspect) body.aspect_ratio = aspect;
-			if (config.supportsResolution) body.resolution = model === "grok-image" || model === "grok-image-2" ? resolution.toLowerCase() : resolution;
+			if (config.supportsResolution) body.resolution = model === "grok-image" || model === "grok-image-2" || model === "grok-image-quality" ? resolution.toLowerCase() : resolution;
 	}
-	if (config.supportsQuality === true) body.quality = quality ?? "high";
+	if (config.supportsQuality === true) body.quality = quality ?? config.defaultQuality ?? "high";
 	if (config.supportsBackground === true && background) body.background = background;
 	if (config.supportsBackground === true && transparent === true) body.background = "transparent";
 	if (transparent === true && config.supportsOutputFormat === true) body.output_format = "png";
@@ -5047,134 +5312,7 @@ const TIERS = [
 ];
 const DEFAULT_TIER = "balanced";
 const HAND_RANKED_AT = "2026-09-16";
-const GENERATION_MODELS_RANKED = [
-	{
-		model: "gpt2",
-		tier: "quality"
-	},
-	{
-		model: "banana2",
-		tier: "quality"
-	},
-	{
-		model: "gpt",
-		tier: "quality"
-	},
-	{
-		model: "sunburst",
-		tier: "quality"
-	},
-	{
-		model: "gemini3",
-		tier: "quality"
-	},
-	{
-		model: "mai-image-2.5-pro",
-		tier: "quality"
-	},
-	{
-		model: "seedream5",
-		tier: "quality"
-	},
-	{
-		model: "flux2-max",
-		tier: "quality"
-	},
-	{
-		model: "banana",
-		tier: "balanced"
-	},
-	{
-		model: "ideogram3-transparent",
-		requires: ["transparency"],
-		supports: ["transparency"],
-		tier: "balanced"
-	},
-	{
-		model: "flare",
-		tier: "balanced"
-	},
-	{
-		model: "banana2-lite",
-		tier: "balanced"
-	},
-	{
-		model: "qwen3",
-		tier: "balanced"
-	},
-	{
-		model: "seedream4",
-		tier: "balanced"
-	},
-	{
-		model: "flux2-flex",
-		tier: "balanced"
-	},
-	{
-		model: "ideogram4",
-		tier: "balanced"
-	},
-	{
-		model: "grok-image",
-		tier: "balanced"
-	},
-	{
-		model: "recraft4",
-		tier: "balanced"
-	},
-	{
-		model: "flux2-pro",
-		tier: "balanced"
-	},
-	{
-		model: "seedream45",
-		tier: "balanced"
-	},
-	{
-		model: "grok-image-2",
-		tier: "balanced"
-	},
-	{
-		model: "recraft41",
-		tier: "balanced"
-	},
-	{
-		model: "flux2-turbo",
-		tier: "fast"
-	},
-	{
-		model: "flux2-dev",
-		tier: "fast"
-	},
-	{
-		model: "flux-fast",
-		tier: "fast"
-	},
-	{
-		model: "seedream5-lite",
-		tier: "fast"
-	},
-	{
-		model: "gemini",
-		tier: "fast"
-	},
-	{
-		model: "qwen",
-		tier: "fast"
-	},
-	{
-		model: "ideogram",
-		tier: "fast"
-	},
-	{
-		model: "recraft",
-		tier: "fast"
-	},
-	{
-		model: "flux",
-		tier: "fast"
-	}
-];
+const IMAGE_RANKED_AT = "2026-10-29";
 /** Every Task with a Model. A Task is absent here until it has at least one Model. */
 const TASKS = {
 	animate: {
@@ -5345,10 +5483,109 @@ const TASKS = {
 		summary: "Remove an object, person, text or clutter from an image and fill the gap."
 	},
 	generate: {
-		basis: "Hand-ranked. Tiers set by fal price per image (quality ≥ $0.07, balanced $0.02-$0.15 with edit quality, fast ≤ $0.04); order within a tier by Artificial Analysis text-to-image Elo, snapshot 2026-08-23, unranked models last. banana leads balanced because it is the house default the looks are tuned on. Ideogram V3 Transparent follows it but is chosen only for a transparent request, so transparency needs no OpenAI key at balanced; token-metered Nano Banana 2 Lite sits in balanced by its Elo.",
-		models: GENERATION_MODELS_RANKED,
+		basis: "Order follows Arena text-to-image (https://arena.ai/leaderboard/image/text-to-image), read 2026-10-29 (MOT-72). Sunburst and Flare lead quality at the benchmarked max setting. Balanced starts with Nano Banana 2.1 on preliminary Arena evidence, then Grok Image 2 and Muse Image. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Fast keeps Nano Banana 2 Lite, budget Grok and Seedream 5 Lite, and FLUX.2 Turbo. Design, transparency and tuned Look routes are capability exceptions. Generation with References uses the separate editing ranking. Older routes are explicit/pin/Look-only.",
+		models: [
+			{
+				model: "sunburst",
+				tier: "quality"
+			},
+			{
+				model: "flare",
+				tier: "quality"
+			},
+			{
+				model: "gpt2",
+				tier: "quality"
+			},
+			{
+				model: "seedream5",
+				tier: "quality"
+			},
+			{
+				model: "gpt",
+				tier: "quality"
+			},
+			{
+				model: "mai-image-2.5-pro",
+				tier: "quality"
+			},
+			{
+				model: "banana21",
+				tier: "balanced"
+			},
+			{
+				model: "grok-image-2",
+				tier: "balanced"
+			},
+			{
+				model: "muse-image",
+				tier: "balanced"
+			},
+			{
+				model: "banana2",
+				tier: "balanced"
+			},
+			{
+				model: "qwen3",
+				tier: "balanced"
+			},
+			{
+				model: "mai-image-2.5",
+				tier: "balanced"
+			},
+			{
+				model: "banana",
+				tier: "balanced"
+			},
+			{
+				model: "ideogram4",
+				tier: "balanced"
+			},
+			{
+				model: "flux2-flex",
+				tier: "balanced"
+			},
+			{
+				model: "recraft41",
+				tier: "balanced"
+			},
+			{
+				model: "flux2-pro",
+				tier: "balanced"
+			},
+			{
+				model: "krea3",
+				tier: "balanced"
+			},
+			{
+				model: "grok-image-quality",
+				tier: "balanced"
+			},
+			{
+				model: "ideogram3-transparent",
+				requires: ["transparency"],
+				supports: ["transparency"],
+				tier: "balanced"
+			},
+			{
+				model: "banana2-lite",
+				tier: "fast"
+			},
+			{
+				model: "grok-image",
+				tier: "fast"
+			},
+			{
+				model: "seedream5-lite",
+				tier: "fast"
+			},
+			{
+				model: "flux2-turbo",
+				tier: "fast"
+			}
+		],
 		notFor: "Variations of an image you already have (vary), or a consistent set of images (series run).",
-		rankedAt: HAND_RANKED_AT,
+		rankedAt: IMAGE_RANKED_AT,
 		rankedFrom: "hand",
 		summary: "Make an image from a prompt, or change an image you pass as a reference."
 	},
@@ -5833,10 +6070,91 @@ const TASKS = {
 		summary: "Trace a raster image to a clean SVG."
 	},
 	vary: {
-		basis: "The generate ranking, filtered to Models that can edit. vary reuses the Model of the image it varies while Motif still offers it.",
-		models: GENERATION_MODELS_RANKED.filter(({ model }) => MODELS[model]?.supportsEdit === true),
+		basis: "Order follows Arena image edit, single image (https://arena.ai/leaderboard/image/image-edit/single-image), read 2026-10-29 (MOT-72). Editing order differs from generation: Grok Image 2 leads balanced, ahead of Nano Banana 2.1, and Seedream 5 Pro outranks GPT Image 1.5. Arena scores Krea 3 only at its Ultra setting, which costs $0.27 to $0.35 an edit and ignores the requested size, so krea3, which runs fal's default setting, is ranked as unscored. Models not yet on the board follow the ranked ones in their Tier, in their previous order. The Artificial Analysis v2 snapshot of 2026-10-07 stays as recorded benchmark data. Sunburst and Flare use max quality. vary reuses a previously chosen Model when explicitly supplied, including retained legacy routes.",
+		models: [
+			{
+				model: "sunburst",
+				tier: "quality"
+			},
+			{
+				model: "flare",
+				tier: "quality"
+			},
+			{
+				model: "gpt2",
+				tier: "quality"
+			},
+			{
+				model: "seedream5",
+				tier: "quality"
+			},
+			{
+				model: "gpt",
+				tier: "quality"
+			},
+			{
+				model: "mai-image-2.5-pro",
+				tier: "quality"
+			},
+			{
+				model: "grok-image-2",
+				tier: "balanced"
+			},
+			{
+				model: "banana21",
+				tier: "balanced"
+			},
+			{
+				model: "mai-image-2.5",
+				tier: "balanced"
+			},
+			{
+				model: "muse-image",
+				tier: "balanced"
+			},
+			{
+				model: "grok-image-quality",
+				tier: "balanced"
+			},
+			{
+				model: "banana",
+				tier: "balanced"
+			},
+			{
+				model: "banana2",
+				tier: "balanced"
+			},
+			{
+				model: "krea3",
+				tier: "balanced"
+			},
+			{
+				model: "qwen3",
+				tier: "balanced"
+			},
+			{
+				model: "flux2-pro",
+				tier: "balanced"
+			},
+			{
+				model: "flux2-flex",
+				tier: "balanced"
+			},
+			{
+				model: "grok-image",
+				tier: "fast"
+			},
+			{
+				model: "banana2-lite",
+				tier: "fast"
+			},
+			{
+				model: "seedream5-lite",
+				tier: "fast"
+			}
+		],
 		notFor: "A specific change to an image described in words (generate with a reference), or a set of different scenes in one style (series run).",
-		rankedAt: HAND_RANKED_AT,
+		rankedAt: IMAGE_RANKED_AT,
 		rankedFrom: "hand",
 		summary: "Make variations of an image you already have."
 	}
@@ -8221,7 +8539,7 @@ function resolveFixed(task, fixed, request, needed, keys) {
 	const { chosenBy, model } = fixed;
 	const tier = request.tier ?? "balanced";
 	const entries = TASKS[task].models;
-	const entry = entries.find((candidate) => candidate.model === model && candidate.mode === request.mode);
+	const entry = entries.find((candidate) => candidate.model === model && candidate.mode === request.mode) ?? legacyEntry(task, model, request.mode, tier);
 	const profile = modelProfile(model);
 	if (entry === void 0 || profile === void 0) {
 		const servesTask = entries.some((candidate) => candidate.model === model);
@@ -8234,6 +8552,14 @@ function resolveFixed(task, fixed, request, needed, keys) {
 	unblockers.push(unblockerFor(result));
 	return unresolved(task, result.blockedBy, unblockers, `${model} (${chosenBy}) ${describeBlock(result.blockedBy, result.missingKey, result.missingInput)}.`, result.missingKey);
 }
+/** Old pins and tuned Looks remain usable without recommending predecessors. */
+function legacyEntry(task, model, mode, tier) {
+	if (mode !== void 0 || task !== "generate" && task !== "vary" || !LEGACY_GENERATION_MODELS.some((id) => id === model) || task === "vary" && MODELS[model]?.supportsEdit !== true) return;
+	return {
+		model,
+		tier
+	};
+}
 function unknownForMode(task, model, mode, entries) {
 	const otherModes = entries.filter((candidate) => candidate.model === model).map((candidate) => candidate.mode ?? "no mode");
 	const inMode = [...new Set(entries.filter((candidate) => candidate.mode === mode).map((candidate) => candidate.model))];
@@ -8250,7 +8576,7 @@ function resolveRanked(task, request, needed, keys) {
 	const qualifying = /* @__PURE__ */ new Map();
 	let firstBlock;
 	let keyBlock;
-	const definition = TASKS[task];
+	const definition = task === "generate" && (request.references ?? 0) > 0 ? TASKS.vary : TASKS[task];
 	for (const entry of definition.models) {
 		if (entry.mode !== request.mode) continue;
 		const { model, tier: modelTier } = entry;
@@ -8399,6 +8725,8 @@ const FAL_IMAGE_PRICE_USD = {
 	"ideogram/v4": MODELS.ideogram4?.pricePerImageUsd ?? .03,
 	"xai/grok-imagine-image": MODELS["grok-image"]?.pricePerImageUsd ?? .02,
 	"xai/grok-imagine-image/v2.0/text-to-image": MODELS["grok-image-2"]?.pricePerImageUsd ?? .06,
+	"xai/grok-imagine-image/quality/text-to-image": MODELS["grok-image-quality"]?.pricePerImageUsd ?? .05,
+	"meta/muse-image/text-to-image": MODELS["muse-image"]?.pricePerImageUsd ?? .01,
 	"microsoft/mai-image-2.5-pro": MODELS["mai-image-2.5-pro"]?.pricePerImageUsd ?? .17,
 	"fal-ai/ideogram/v3/generate-transparent": MODELS["ideogram3-transparent"]?.pricePerImageUsd ?? .06,
 	"alibaba/qwen-image-3/text-to-image": MODELS.qwen3?.pricePerImageUsd ?? .04,