@dickpy/dsh-imagegen 1.2.2 → 1.2.3

package/lib/index.js

@@ -16,7 +16,7 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 /** Settings namespace this plugin owns (host settings seam + bridge). */
 const IMAGEGEN_SETTINGS_NAMESPACE = "dsh-imagegen";
 /** Published package version shared by the host updater and the client UI. */
-const PLUGIN_VERSION = "1.2.2";
+const PLUGIN_VERSION = "1.2.3";
 /** Same-origin route family (loopback-only, mirroring the dsh-ssh fence). */
 const SETTINGS_API = {
 	describe: "/api/dsh-imagegen/settings/describe",
@@ -140,7 +140,14 @@ async function enhancePrompt(config, prompt) {
 * `/models` exposes candidates only: the configured list is the explicit
 * allow-list because OpenAI-compatible gateways rarely advertise modalities.
 */
-const DEFAULT_IMAGE_MODELS = ["gpt-image-2", "grok-imagine-image"];
+const DEFAULT_IMAGE_MODELS = [
+	"gpt-image-2",
+	"grok-imagine-image",
+	"nanobanana2",
+	"nanobanana2-lite",
+	"nanobanana-pro",
+	"seedream-5.0-pro"
+];
 /** Normalize user-entered model identifiers and retain a usable legacy default. */
 function normalizeImageModels(value) {
 	const candidates = Array.isArray(value) ? value : [];
@@ -183,6 +190,24 @@ const DALLE3_SIZES = /* @__PURE__ */ new Set([
 function isGrokImagine(model) {
 	return /^grok-imagine(?:-|$)/.test(model);
 }
+/** Whether the model belongs to the Google Nano Banana family (nanobanana2 /
+*  nanobanana2-lite / nanobanana-pro, plus the official Gemini image IDs the
+*  gateways expose). OpenAI-compatible gateways serve these with their own
+*  aspect_ratio / image_size vocabulary instead of the OpenAI size/quality
+*  passthrough. */
+function isNanoBanana(model) {
+	if (/^nanobanana/i.test(model)) return true;
+	return model === "gemini-3-pro-image" || model === "gemini-3-pro-image-preview" || model === "gemini-3.1-flash-image" || model === "gemini-3.1-flash-image-preview" || model === "gemini-3.1-flash-lite-image" || model === "gemini-2.5-flash-image";
+}
+/** Whether the model belongs to the ByteDance Seedream family (seedream-5.0-pro,
+*  seedream-5.0, seedream-4.x, doubao-seedream-…). OpenAI-compatible gateways
+*  serve Seedream through a unified generate-and-edit architecture:
+*  generation AND editing both go to /images/generations, reference images are
+*  a JSON URL / data-URL array, and the clarity tier is `resolution` while
+*  `size` carries the aspect ratio (or exact pixels). */
+function isSeedream(model) {
+	return /^(?:doubao-)?seedream/i.test(model);
+}
 /** The panel's aspect ratios mapped to the closest OpenAI pixel size
 *  (gpt-image-2 / generic OpenAI-compatible endpoints). */
 const OPENAI_SIZE_BY_RATIO = {
@@ -273,6 +298,18 @@ function effectiveParams(request) {
 		...request.quality !== "" && request.quality !== "auto" ? { resolution: request.quality === "4k" ? "2k" : request.quality } : {},
 		response_format: "b64_json"
 	};
+	if (isNanoBanana(model)) return {
+		model,
+		...request.size !== "" && request.size !== "auto" ? { aspect_ratio: request.size } : {},
+		...request.quality !== "" && request.quality !== "auto" ? { image_size: request.quality.toUpperCase() } : {},
+		response_format: "b64_json"
+	};
+	if (isSeedream(model)) return {
+		model,
+		...request.size !== "" && request.size !== "auto" ? { size: request.size } : {},
+		...request.quality !== "" && request.quality !== "auto" ? { resolution: request.quality === "4k" ? "2K" : request.quality.toUpperCase() } : {},
+		response_format: "b64_json"
+	};
 	return {
 		model,
 		...request.size !== "" && request.size !== "auto" && OPENAI_SIZE_BY_RATIO[request.size] !== void 0 ? { size: OPENAI_SIZE_BY_RATIO[request.size] } : {},
@@ -358,6 +395,24 @@ async function requestOneImage(baseUrl, upstream, request, params, signal) {
 				...params.aspect_ratio !== void 0 ? { aspect_ratio: params.aspect_ratio } : {},
 				response_format: "b64_json"
 			});
+		} else if (isNanoBanana(params.model)) {
+			const form = new FormData();
+			form.append("image", new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf$2(parsed.mime)}`);
+			form.append("prompt", request.prompt);
+			form.append("model", params.model);
+			if (params.aspect_ratio !== void 0) form.append("aspect_ratio", params.aspect_ratio);
+			if (params.image_size !== void 0) form.append("image_size", params.image_size);
+			body = form;
+		} else if (isSeedream(params.model)) {
+			headers["content-type"] = "application/json";
+			body = JSON.stringify({
+				model: params.model,
+				prompt: request.prompt,
+				image: [request.image],
+				...params.size !== void 0 ? { size: params.size } : {},
+				...params.resolution !== void 0 ? { resolution: params.resolution } : {},
+				response_format: "b64_json"
+			});
 		} else {
 			const form = new FormData();
 			form.append("image", new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf$2(parsed.mime)}`);
@@ -378,7 +433,8 @@ async function requestOneImage(baseUrl, upstream, request, params, signal) {
 	const budget = requestSignal(signal, UPSTREAM_TIMEOUT_MS);
 	let response;
 	try {
-		response = await fetch(`${baseUrl}/images/${request.mode === "edit" ? "edits" : "generations"}`, {
+		const endpoint = request.mode === "edit" && !isSeedream(params.model) ? "/images/edits" : "/images/generations";
+		response = await fetch(`${baseUrl}${endpoint}`, {
 			method: "POST",
 			headers,
 			body,
@@ -2623,7 +2679,7 @@ const DEFAULT_ALLOW_AGENT_IMAGE_GENERATION = true;
 /** Order of the announcement section within the tool-guidance band. */
 const SECTION_ORDER = 150;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-const IMAGEGEN_GUIDANCE = "本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：对接 OpenAI 兼容图像生成 API，模型由用户在「设置 → 插件 → AI 生图」中检测或手动配置的生图模型列表决定；支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送）。API 地址与密钥在 GUI 设置中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用已配置的生图模型；模型出现在 /models 中不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选与复用。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片直接作为工具结果附件返回，不会额外伪造用户消息。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。";
+const IMAGEGEN_GUIDANCE = "本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：对接 OpenAI 兼容图像生成 API，模型由用户在「设置 → 插件 → AI 生图」中检测或手动配置的生图模型列表决定；支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送，nanobanana 系列按 aspect_ratio / image_size 参数协议发送；seedream 系列统一走 /images/generations，参考图以 JSON image 数组发送）。API 地址与密钥在 GUI 设置中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用已配置的生图模型；模型出现在 /models 中不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选与复用。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片直接作为工具结果附件返回，不会额外伪造用户消息。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。";
 /** Add the live allow-list so an Agent can honor a user's model choice. */
 function guidanceFor(imageModels) {
 	return `${IMAGEGEN_GUIDANCE} 当前允许调用的生图模型：${imageModels.join("、")}。用户指定其中某个模型时，工具参数 model 必须使用该精确名称；未指定时使用列表中的第一个。`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dickpy/dsh-imagegen",
-  "description": "AI 鐢熷浘 (image generation) plugin for the dsh web GUI: text-to-image and image-to-image through a configurable OpenAI-compatible endpoint (gpt-image-2 / grok-imagine-image / dall-e-3, with native xAI Grok Imagine request shaping), with a settings card for api_url / api_key and a sidebar entry opening a split-pane generation studio.",
-  "version": "1.2.2",
+  "description": "AI 鐢熷浘 (image generation) plugin for the dsh web GUI: text-to-image and image-to-image through a configurable OpenAI-compatible endpoint (gpt-image-2 / grok-imagine-image / nanobanana series / seedream-5.0-pro / dall-e-3, with native xAI Grok Imagine, Google Nano Banana and ByteDance Seedream request shaping), with a settings card for api_url / api_key and a sidebar entry opening a split-pane generation studio.",
+  "version": "1.2.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {

package/src/client/ImageGenPanel.tsx

@@ -1127,7 +1127,7 @@ export function ImageGenPanel(props: {
                           <span className={css.galleryBadge}>{entry.mode === 'edit' ? tt('mode.edit') : tt('mode.text')}</span>
                         </button>
                         <div className={css.galleryCardFooter}>
-                          <span className={css.galleryAvatar}>{entry.model.startsWith('grok') ? 'G' : 'D'}</span>
+                          <span className={css.galleryAvatar}>{entry.model.toLowerCase().startsWith('nanobanana') ? 'N' : entry.model.toLowerCase().startsWith('seedream') ? 'S' : entry.model.startsWith('grok') ? 'G' : 'D'}</span>
                           <span className={css.galleryCardInfo}>
                             <strong>{entry.prompt || tt('gallery.untitled')}</strong>
                             <small>{entry.model} · {normalizeSize(entry.size)} · {formatTime(entry.createdAt)}</small>

package/src/client/locales.ts

@@ -4,7 +4,7 @@
 
 export const zh = {
   'entry.label': 'AI 生图',
-  'entry.tooltip': 'AI 生图面板（gpt-image-2 / grok-imagine-image）',
+  'entry.tooltip': 'AI 生图面板（gpt-image-2 / grok-imagine-image / nanobanana / seedream 系列）',
   'panel.title': 'AI 生图',
   'panel.githubTip': '觉得好用或有建议？欢迎来 GitHub 提 issues、点个 star 支持一下！',
   // mode
@@ -253,7 +253,7 @@ export const zh = {
 
 export const en: Record<keyof typeof zh, string> = {
   'entry.label': 'AI Image',
-  'entry.tooltip': 'AI image generation studio (gpt-image-2 / grok-imagine-image)',
+  'entry.tooltip': 'AI image generation studio (gpt-image-2 / grok-imagine-image / nanobanana / seedream family)',
   'panel.title': 'AI Image',
   'panel.githubTip': 'Like it or have suggestions? Head to GitHub to open issues and star us!',
   'mode.text': 'Text to Image',

package/src/engine.ts

@@ -50,6 +50,31 @@ function isGrokImagine(model: string): boolean {
   return /^grok-imagine(?:-|$)/.test(model)
 }
 
+/** Whether the model belongs to the Google Nano Banana family (nanobanana2 /
+ *  nanobanana2-lite / nanobanana-pro, plus the official Gemini image IDs the
+ *  gateways expose). OpenAI-compatible gateways serve these with their own
+ *  aspect_ratio / image_size vocabulary instead of the OpenAI size/quality
+ *  passthrough. */
+function isNanoBanana(model: string): boolean {
+  if (/^nanobanana/i.test(model)) return true
+  return (
+    model === 'gemini-3-pro-image' || model === 'gemini-3-pro-image-preview' ||
+    model === 'gemini-3.1-flash-image' || model === 'gemini-3.1-flash-image-preview' ||
+    model === 'gemini-3.1-flash-lite-image' ||
+    model === 'gemini-2.5-flash-image'
+  )
+}
+
+/** Whether the model belongs to the ByteDance Seedream family (seedream-5.0-pro,
+ *  seedream-5.0, seedream-4.x, doubao-seedream-…). OpenAI-compatible gateways
+ *  serve Seedream through a unified generate-and-edit architecture:
+ *  generation AND editing both go to /images/generations, reference images are
+ *  a JSON URL / data-URL array, and the clarity tier is `resolution` while
+ *  `size` carries the aspect ratio (or exact pixels). */
+function isSeedream(model: string): boolean {
+  return /^(?:doubao-)?seedream/i.test(model)
+}
+
 /** The panel's aspect ratios mapped to the closest OpenAI pixel size
  *  (gpt-image-2 / generic OpenAI-compatible endpoints). */
 const OPENAI_SIZE_BY_RATIO: Readonly<Record<string, string>> = {
@@ -136,6 +161,7 @@ function effectiveParams(request: GenerateRequest): {
   quality?: string
   detail?: string
   aspect_ratio?: string
+  image_size?: string
   resolution?: string
   response_format?: string
 } {
@@ -163,6 +189,39 @@ function effectiveParams(request: GenerateRequest): {
       response_format: 'b64_json',
     }
   }
+  // Google Nano Banana: the panel's aspect ratios are sent as-is (the family
+  // documents 1:1 … 21:9 natively), the clarity tiers become image_size
+  // (1K / 2K / 4K — Gen 1 and 2-Lite are 1K-only upstream, but which gateway
+  // rejects higher tiers is its own call), and base64 output keeps any signed
+  // result URLs from expiring before the host downloads them.
+  if (isNanoBanana(model)) {
+    return {
+      model,
+      ...request.size !== '' && request.size !== 'auto'
+        ? { aspect_ratio: request.size }
+        : {},
+      ...request.quality !== '' && request.quality !== 'auto'
+        ? { image_size: request.quality.toUpperCase() }
+        : {},
+      response_format: 'b64_json',
+    }
+  }
+  // ByteDance Seedream: OpenAI-compatible gateways accept the aspect ratio in
+  // `size` directly and the clarity tiers as `resolution` (1K / 2K; the 5.0-pro
+  // tier caps at 2K, so 4k falls back to 2K). There is no quality/detail knob,
+  // and edits reuse /images/generations with an image array (see below).
+  if (isSeedream(model)) {
+    return {
+      model,
+      ...request.size !== '' && request.size !== 'auto'
+        ? { size: request.size }
+        : {},
+      ...request.quality !== '' && request.quality !== 'auto'
+        ? { resolution: request.quality === '4k' ? '2K' : request.quality.toUpperCase() }
+        : {},
+      response_format: 'b64_json',
+    }
+  }
   // OpenAI-compatible endpoints: nearest pixel size, clarity tiers mapped to
   // the quality levels (1k→low / 2k→medium / 4k→high), detail passthrough.
   return {
@@ -268,6 +327,28 @@ async function requestOneImage(
         ...params.aspect_ratio !== undefined ? { aspect_ratio: params.aspect_ratio } : {},
         response_format: 'b64_json',
       })
+    } else if (isNanoBanana(params.model)) {
+      // Nano Banana OpenAI-compatible gateways accept the standard multipart
+      // edit upload, with the family's own aspect_ratio / image_size knobs.
+      const form = new FormData()
+      form.append('image', new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf(parsed.mime)}`)
+      form.append('prompt', request.prompt)
+      form.append('model', params.model)
+      if (params.aspect_ratio !== undefined) form.append('aspect_ratio', params.aspect_ratio)
+      if (params.image_size !== undefined) form.append('image_size', params.image_size)
+      body = form
+    } else if (isSeedream(params.model)) {
+      // Seedream unifies generation and editing on /images/generations; the
+      // reference image is a JSON URL / data-URL array, never multipart.
+      headers['content-type'] = 'application/json'
+      body = JSON.stringify({
+        model: params.model,
+        prompt: request.prompt,
+        image: [request.image],
+        ...params.size !== undefined ? { size: params.size } : {},
+        ...params.resolution !== undefined ? { resolution: params.resolution } : {},
+        response_format: 'b64_json',
+      })
     } else {
       const form = new FormData()
       form.append('image', new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf(parsed.mime)}`)
@@ -286,7 +367,11 @@ async function requestOneImage(
   const budget = requestSignal(signal, UPSTREAM_TIMEOUT_MS)
   let response: Response
   try {
-    response = await fetch(`${baseUrl}/images/${request.mode === 'edit' ? 'edits' : 'generations'}`, {
+    // Seedream has no /images/edits endpoint: both modes hit generations.
+    const endpoint = request.mode === 'edit' && !isSeedream(params.model)
+      ? '/images/edits'
+      : '/images/generations'
+    response = await fetch(`${baseUrl}${endpoint}`, {
       method: 'POST',
       headers,
       body,

package/src/image-models.ts

@@ -4,7 +4,7 @@
  * allow-list because OpenAI-compatible gateways rarely advertise modalities.
  */
 
-export const DEFAULT_IMAGE_MODELS = ['gpt-image-2', 'grok-imagine-image'] as const
+export const DEFAULT_IMAGE_MODELS = ['gpt-image-2', 'grok-imagine-image', 'nanobanana2', 'nanobanana2-lite', 'nanobanana-pro', 'seedream-5.0-pro'] as const
 
 /** Normalize user-entered model identifiers and retain a usable legacy default. */
 export function normalizeImageModels(value: unknown): string[] {

package/src/index.ts

@@ -83,7 +83,7 @@ const DEFAULT_ALLOW_AGENT_IMAGE_GENERATION = true
 const SECTION_ORDER = 150
 
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-export const IMAGEGEN_GUIDANCE = '本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：对接 OpenAI 兼容图像生成 API，模型由用户在「设置 → 插件 → AI 生图」中检测或手动配置的生图模型列表决定；支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送）。API 地址与密钥在 GUI 设置中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用已配置的生图模型；模型出现在 /models 中不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选与复用。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片直接作为工具结果附件返回，不会额外伪造用户消息。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。'
+export const IMAGEGEN_GUIDANCE = '本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：对接 OpenAI 兼容图像生成 API，模型由用户在「设置 → 插件 → AI 生图」中检测或手动配置的生图模型列表决定；支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送，nanobanana 系列按 aspect_ratio / image_size 参数协议发送；seedream 系列统一走 /images/generations，参考图以 JSON image 数组发送）。API 地址与密钥在 GUI 设置中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用已配置的生图模型；模型出现在 /models 中不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选与复用。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片直接作为工具结果附件返回，不会额外伪造用户消息。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。'
 
 /** Add the live allow-list so an Agent can honor a user's model choice. */
 function guidanceFor(imageModels: string[]): string {

package/src/protocol.ts

@@ -8,7 +8,7 @@
 export const IMAGEGEN_SETTINGS_NAMESPACE = 'dsh-imagegen'
 
 /** Published package version shared by the host updater and the client UI. */
-export const PLUGIN_VERSION = '1.2.2'
+export const PLUGIN_VERSION = '1.2.3'
 
 /** Same-origin route family (loopback-only, mirroring the dsh-ssh fence). */
 export const SETTINGS_API = {
@@ -145,11 +145,13 @@ export interface GenerateRequest {
   /** The prompt. Upstream providers may impose their own length limits. */
   prompt: string
   /** Canvas size as an aspect ratio: 'auto' or e.g. '1:1' / '16:9' / '21:9'.
-   *  The host maps it onto each model's own vocabulary (aspect_ratio for Grok,
-   *  the closest pixel size for OpenAI-compatible endpoints). */
+   *  The host maps it onto each model's own vocabulary (aspect_ratio for Grok
+   *  and Nano Banana, size-aspect for Seedream, the closest pixel size for
+   *  OpenAI-compatible endpoints). */
   size: string
   /** Clarity tier: 'auto' | '1k' | '2k' | '4k'. The host maps it onto the
-   *  model's own vocabulary (resolution for Grok, quality for OpenAI). */
+   *  model's own vocabulary (resolution for Grok / Seedream, image_size for
+   *  Nano Banana, quality for OpenAI). */
   quality: string
   /** Number of images, 1-4. */
   n: number