@lobehub/chat 1.102.4 → 1.103.0

package/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 # Changelog
 
+## [Version 1.103.0](https://github.com/lobehub/lobe-chat/compare/v1.102.4...v1.103.0)
+
+<sup>Released on **2025-07-22**</sup>
+
+#### ✨ Features
+
+- **misc**: Add Qwen image generation capabilities.
+
+<br/>
+
+<details>
+<summary><kbd>Improvements and Fixes</kbd></summary>
+
+#### What's improved
+
+- **misc**: Add Qwen image generation capabilities, closes [#8534](https://github.com/lobehub/lobe-chat/issues/8534) ([7e8e5ef](https://github.com/lobehub/lobe-chat/commit/7e8e5ef))
+
+</details>
+
+<div align="right">
+
+[![](https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square)](#readme-top)
+
+</div>
+
 ### [Version 1.102.4](https://github.com/lobehub/lobe-chat/compare/v1.102.3...v1.102.4)
 
 <sup>Released on **2025-07-22**</sup>

package/changelog/v1.json

@@ -1,4 +1,13 @@
 [
+  {
+    "children": {
+      "features": [
+        "Add Qwen image generation capabilities."
+      ]
+    },
+    "date": "2025-07-22",
+    "version": "1.103.0"
+  },
   {
     "children": {
       "improvements": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lobehub/chat",
-  "version": "1.102.4",
+  "version": "1.103.0",
   "description": "Lobe Chat - an open-source, high-performance chatbot framework that supports speech synthesis, multimodal, and extensible Function Call plugin system. Supports one-click free deployment of your private ChatGPT/LLM web application.",
   "keywords": [
     "framework",

package/src/config/aiModels/qwen.ts

@@ -1,4 +1,4 @@
-import { AIChatModelCard } from '@/types/aiModel';
+import { AIChatModelCard, AIImageModelCard } from '@/types/aiModel';
 
 // https://help.aliyun.com/zh/model-studio/models?spm=a2c4g.11186623
 
@@ -956,6 +956,26 @@ const qwenChatModels: AIChatModelCard[] = [
   },
 ];
 
-export const allModels = [...qwenChatModels];
+const qwenImageModels: AIImageModelCard[] = [
+  {
+    description: '阿里云通义旗下的文生图模型',
+    displayName: 'Wanxiang T2I Turbo',
+    enabled: true,
+    id: 'wanx2.1-t2i-turbo',
+    organization: 'Qwen',
+    parameters: {
+      height: { default: 1024, max: 1440, min: 512, step: 1 },
+      prompt: {
+        default: '',
+      },
+      seed: { default: null },
+      width: { default: 1024, max: 1440, min: 512, step: 1 },
+    },
+    releasedAt: '2025-01-08',
+    type: 'image',
+  },
+];
+
+export const allModels = [...qwenChatModels, ...qwenImageModels];
 
 export default allModels;

package/src/libs/model-runtime/qwen/createImage.test.ts

@@ -0,0 +1,613 @@
+// @vitest-environment edge-runtime
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { CreateImagePayload } from '../types/image';
+import { CreateImageOptions } from '../utils/openaiCompatibleFactory';
+import { createQwenImage } from './createImage';
+
+// Mock the console.error to avoid polluting test output
+vi.spyOn(console, 'error').mockImplementation(() => {});
+
+const mockOptions: CreateImageOptions = {
+  apiKey: 'test-api-key',
+  provider: 'qwen',
+};
+
+beforeEach(() => {
+  // Reset all mocks before each test
+  vi.clearAllMocks();
+});
+
+afterEach(() => {
+  vi.clearAllMocks();
+});
+
+describe('createQwenImage', () => {
+  describe('Success scenarios', () => {
+    it('should successfully generate image with immediate success', async () => {
+      const mockTaskId = 'task-123456';
+      const mockImageUrl = 'https://dashscope.oss-cn-beijing.aliyuncs.com/aigc/test-image.jpg';
+
+      // Mock fetch for task creation and immediate success
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-123',
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: {
+              task_id: mockTaskId,
+              task_status: 'SUCCEEDED',
+              results: [{ url: mockImageUrl }],
+            },
+            request_id: 'req-124',
+          }),
+        });
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'A beautiful sunset over the mountains',
+        },
+      };
+
+      const result = await createQwenImage(payload, mockOptions);
+
+      // Verify task creation request
+      expect(fetch).toHaveBeenCalledWith(
+        'https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis',
+        {
+          method: 'POST',
+          headers: {
+            'Authorization': 'Bearer test-api-key',
+            'Content-Type': 'application/json',
+            'X-DashScope-Async': 'enable',
+          },
+          body: JSON.stringify({
+            input: {
+              prompt: 'A beautiful sunset over the mountains',
+            },
+            model: 'wanx2.1-t2i-turbo',
+            parameters: {
+              n: 1,
+              size: '1024*1024',
+            },
+          }),
+        },
+      );
+
+      // Verify status query request
+      expect(fetch).toHaveBeenCalledWith(
+        `https://dashscope.aliyuncs.com/api/v1/tasks/${mockTaskId}`,
+        {
+          headers: {
+            Authorization: 'Bearer test-api-key',
+          },
+        },
+      );
+
+      expect(result).toEqual({
+        imageUrl: mockImageUrl,
+      });
+    });
+
+    it('should handle task that needs polling before success', async () => {
+      const mockTaskId = 'task-polling';
+      const mockImageUrl = 'https://dashscope.oss-cn-beijing.aliyuncs.com/aigc/test-image-3.jpg';
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-127',
+          }),
+        })
+        // First status query - still running
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: {
+              task_id: mockTaskId,
+              task_status: 'RUNNING',
+            },
+            request_id: 'req-128',
+          }),
+        })
+        // Second status query - succeeded
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: {
+              task_id: mockTaskId,
+              task_status: 'SUCCEEDED',
+              results: [{ url: mockImageUrl }],
+            },
+            request_id: 'req-129',
+          }),
+        });
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Abstract digital art',
+        },
+      };
+
+      const result = await createQwenImage(payload, mockOptions);
+
+      // Should have made 3 fetch calls: 1 create + 2 status checks
+      expect(fetch).toHaveBeenCalledTimes(3);
+      expect(result).toEqual({
+        imageUrl: mockImageUrl,
+      });
+    });
+
+    it('should handle custom image dimensions', async () => {
+      const mockTaskId = 'task-custom-size';
+      const mockImageUrl = 'https://dashscope.oss-cn-beijing.aliyuncs.com/aigc/custom-size.jpg';
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-140',
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: {
+              task_id: mockTaskId,
+              task_status: 'SUCCEEDED',
+              results: [{ url: mockImageUrl }],
+            },
+            request_id: 'req-141',
+          }),
+        });
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Custom size image',
+          width: 512,
+          height: 768,
+        },
+      };
+
+      await createQwenImage(payload, mockOptions);
+
+      expect(fetch).toHaveBeenCalledWith(
+        'https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis',
+        expect.objectContaining({
+          body: JSON.stringify({
+            input: {
+              prompt: 'Custom size image',
+            },
+            model: 'wanx2.1-t2i-turbo',
+            parameters: {
+              n: 1,
+              size: '512*768',
+            },
+          }),
+        }),
+      );
+    });
+
+    it('should handle long running tasks with retries', async () => {
+      const mockTaskId = 'task-long-running';
+
+      // Mock status query that returns RUNNING a few times then succeeds
+      let statusCallCount = 0;
+      const statusQueryMock = vi.fn().mockImplementation(() => {
+        statusCallCount++;
+        if (statusCallCount <= 3) {
+          return Promise.resolve({
+            ok: true,
+            json: async () => ({
+              output: {
+                task_id: mockTaskId,
+                task_status: 'RUNNING',
+              },
+              request_id: `req-${133 + statusCallCount}`,
+            }),
+          });
+        } else {
+          return Promise.resolve({
+            ok: true,
+            json: async () => ({
+              output: {
+                task_id: mockTaskId,
+                task_status: 'SUCCEEDED',
+                results: [{ url: 'https://example.com/final-image.jpg' }],
+              },
+              request_id: 'req-137',
+            }),
+          });
+        }
+      });
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-132',
+          }),
+        })
+        .mockImplementation(statusQueryMock);
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Long running task',
+        },
+      };
+
+      // Mock setTimeout to make test run faster but still allow controlled execution
+      vi.spyOn(global, 'setTimeout').mockImplementation((callback: any) => {
+        // Use setImmediate to avoid recursion issues
+        setImmediate(callback);
+        return 1 as any;
+      });
+
+      const result = await createQwenImage(payload, mockOptions);
+
+      expect(result).toEqual({
+        imageUrl: 'https://example.com/final-image.jpg',
+      });
+
+      // Should have made 1 create call + 4 status calls (3 RUNNING + 1 SUCCEEDED)
+      expect(fetch).toHaveBeenCalledTimes(5);
+    });
+
+    it('should handle seed value of 0 correctly', async () => {
+      const mockTaskId = 'task-with-zero-seed';
+      const mockImageUrl = 'https://dashscope.oss-cn-beijing.aliyuncs.com/aigc/seed-zero.jpg';
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-seed-0',
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: {
+              task_id: mockTaskId,
+              task_status: 'SUCCEEDED',
+              results: [{ url: mockImageUrl }],
+            },
+            request_id: 'req-seed-0-status',
+          }),
+        });
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Image with seed 0',
+          seed: 0,
+        },
+      };
+
+      await createQwenImage(payload, mockOptions);
+
+      // Verify that seed: 0 is included in the request
+      expect(fetch).toHaveBeenCalledWith(
+        'https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis',
+        expect.objectContaining({
+          body: JSON.stringify({
+            input: {
+              prompt: 'Image with seed 0',
+            },
+            model: 'wanx2.1-t2i-turbo',
+            parameters: {
+              n: 1,
+              seed: 0,
+              size: '1024*1024',
+            },
+          }),
+        }),
+      );
+    });
+  });
+
+  describe('Error scenarios', () => {
+    it('should handle unsupported model', async () => {
+      const payload: CreateImagePayload = {
+        model: 'unsupported-model',
+        params: {
+          prompt: 'Test prompt',
+        },
+      };
+
+      await expect(createQwenImage(payload, mockOptions)).rejects.toEqual(
+        expect.objectContaining({
+          errorType: 'ProviderBizError',
+          provider: 'qwen',
+        }),
+      );
+
+      // Should not make any fetch calls
+      expect(fetch).not.toHaveBeenCalled();
+    });
+
+    it('should handle task creation failure', async () => {
+      global.fetch = vi.fn().mockResolvedValueOnce({
+        ok: false,
+        statusText: 'Bad Request',
+        json: async () => ({
+          message: 'Invalid model name',
+        }),
+      });
+
+      const payload: CreateImagePayload = {
+        model: 'invalid-model',
+        params: {
+          prompt: 'Test prompt',
+        },
+      };
+
+      await expect(createQwenImage(payload, mockOptions)).rejects.toEqual(
+        expect.objectContaining({
+          errorType: 'ProviderBizError',
+          provider: 'qwen',
+        }),
+      );
+    });
+
+    it('should handle non-JSON error responses', async () => {
+      global.fetch = vi.fn().mockResolvedValueOnce({
+        ok: false,
+        status: 500,
+        statusText: 'Internal Server Error',
+        json: async () => {
+          throw new Error('Failed to parse JSON');
+        },
+      });
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Test prompt',
+        },
+      };
+
+      await expect(createQwenImage(payload, mockOptions)).rejects.toEqual(
+        expect.objectContaining({
+          errorType: 'ProviderBizError',
+          provider: 'qwen',
+        }),
+      );
+    });
+
+    it('should handle task failure status', async () => {
+      const mockTaskId = 'task-failed';
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-130',
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: {
+              task_id: mockTaskId,
+              task_status: 'FAILED',
+              error_message: 'Content policy violation',
+            },
+            request_id: 'req-131',
+          }),
+        });
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Invalid prompt that causes failure',
+        },
+      };
+
+      await expect(createQwenImage(payload, mockOptions)).rejects.toEqual(
+        expect.objectContaining({
+          errorType: 'ProviderBizError',
+          provider: 'qwen',
+        }),
+      );
+    });
+
+    it('should handle task succeeded but no results', async () => {
+      const mockTaskId = 'task-no-results';
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-134',
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: {
+              task_id: mockTaskId,
+              task_status: 'SUCCEEDED',
+              results: [], // Empty results array
+            },
+            request_id: 'req-135',
+          }),
+        });
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Test prompt',
+        },
+      };
+
+      await expect(createQwenImage(payload, mockOptions)).rejects.toEqual(
+        expect.objectContaining({
+          errorType: 'ProviderBizError',
+          provider: 'qwen',
+        }),
+      );
+    });
+
+    it('should handle status query failure', async () => {
+      const mockTaskId = 'task-query-fail';
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-136',
+          }),
+        })
+        .mockResolvedValueOnce({
+          ok: false,
+          statusText: 'Unauthorized',
+          json: async () => ({
+            message: 'Invalid API key',
+          }),
+        });
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Test prompt',
+        },
+      };
+
+      await expect(createQwenImage(payload, mockOptions)).rejects.toEqual(
+        expect.objectContaining({
+          errorType: 'ProviderBizError',
+          provider: 'qwen',
+        }),
+      );
+    });
+
+    it('should handle transient status query failures and retry', async () => {
+      const mockTaskId = 'task-transient-failure';
+      const mockImageUrl = 'https://dashscope.oss-cn-beijing.aliyuncs.com/aigc/retry-success.jpg';
+
+      let statusQueryCount = 0;
+      const statusQueryMock = vi.fn().mockImplementation(() => {
+        statusQueryCount++;
+        if (statusQueryCount === 1 || statusQueryCount === 2) {
+          // First two calls fail
+          return Promise.reject(new Error('Network timeout'));
+        } else {
+          // Third call succeeds
+          return Promise.resolve({
+            ok: true,
+            json: async () => ({
+              output: {
+                task_id: mockTaskId,
+                task_status: 'SUCCEEDED',
+                results: [{ url: mockImageUrl }],
+              },
+              request_id: 'req-retry-success',
+            }),
+          });
+        }
+      });
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-transient',
+          }),
+        })
+        .mockImplementation(statusQueryMock);
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Test transient failure',
+        },
+      };
+
+      // Mock setTimeout to make test run faster
+      vi.spyOn(global, 'setTimeout').mockImplementation((callback: any) => {
+        setImmediate(callback);
+        return 1 as any;
+      });
+
+      const result = await createQwenImage(payload, mockOptions);
+
+      expect(result).toEqual({
+        imageUrl: mockImageUrl,
+      });
+
+      // Verify the mock was called the expected number of times
+      expect(statusQueryMock).toHaveBeenCalledTimes(3); // 2 failures + 1 success
+
+      // Should have made 1 create call + 3 status calls (2 failed + 1 succeeded)
+      expect(fetch).toHaveBeenCalledTimes(4);
+    });
+
+    it('should fail after consecutive query failures', async () => {
+      const mockTaskId = 'task-consecutive-failures';
+
+      global.fetch = vi
+        .fn()
+        .mockResolvedValueOnce({
+          ok: true,
+          json: async () => ({
+            output: { task_id: mockTaskId },
+            request_id: 'req-will-fail',
+          }),
+        })
+        // All subsequent calls fail
+        .mockRejectedValue(new Error('Persistent network error'));
+
+      const payload: CreateImagePayload = {
+        model: 'wanx2.1-t2i-turbo',
+        params: {
+          prompt: 'Test persistent failure',
+        },
+      };
+
+      // Mock setTimeout to make test run faster
+      vi.spyOn(global, 'setTimeout').mockImplementation((callback: any) => {
+        setImmediate(callback);
+        return 1 as any;
+      });
+
+      await expect(createQwenImage(payload, mockOptions)).rejects.toEqual(
+        expect.objectContaining({
+          errorType: 'ProviderBizError',
+          provider: 'qwen',
+        }),
+      );
+
+      // Should have made 1 create call + 3 failed status calls (maxConsecutiveFailures)
+      expect(fetch).toHaveBeenCalledTimes(4);
+    });
+  });
+});

package/src/libs/model-runtime/qwen/createImage.ts

@@ -0,0 +1,218 @@
+import createDebug from 'debug';
+
+import { CreateImagePayload, CreateImageResponse } from '../types/image';
+import { AgentRuntimeError } from '../utils/createError';
+import { CreateImageOptions } from '../utils/openaiCompatibleFactory';
+
+const log = createDebug('lobe-image:qwen');
+
+interface QwenImageTaskResponse {
+  output: {
+    error_message?: string;
+    results?: Array<{
+      url: string;
+    }>;
+    task_id: string;
+    task_status: 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED';
+  };
+  request_id: string;
+}
+
+/**
+ * Create an image generation task with Qwen API
+ */
+async function createImageTask(payload: CreateImagePayload, apiKey: string): Promise<string> {
+  const { model, params } = payload;
+  // I can only say that the design of Alibaba Cloud's API is really bad; each model has a different endpoint path.
+  const modelEndpointMap: Record<string, string> = {
+    'wanx2.1-t2i-turbo':
+      'https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis',
+  };
+
+  const endpoint = modelEndpointMap[model];
+  if (!endpoint) {
+    throw new Error(`Unsupported model: ${model}`);
+  }
+  log('Creating image task with model: %s, endpoint: %s', model, endpoint);
+
+  const response = await fetch(endpoint, {
+    body: JSON.stringify({
+      input: {
+        prompt: params.prompt,
+        // negativePrompt is not part of standard parameters
+        // but can be supported by extending the params type if needed
+      },
+      model,
+      parameters: {
+        n: 1,
+        ...(params.seed !== undefined ? { seed: params.seed } : {}),
+        ...(params.width && params.height
+          ? { size: `${params.width}*${params.height}` }
+          : { size: '1024*1024' }),
+      },
+    }),
+    headers: {
+      'Authorization': `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      'X-DashScope-Async': 'enable',
+    },
+    method: 'POST',
+  });
+
+  if (!response.ok) {
+    let errorData;
+    try {
+      errorData = await response.json();
+    } catch {
+      // Failed to parse JSON error response
+    }
+    throw new Error(
+      `Failed to create image task (${response.status}): ${errorData?.message || response.statusText}`,
+    );
+  }
+
+  const data: QwenImageTaskResponse = await response.json();
+  log('Task created with ID: %s', data.output.task_id);
+
+  return data.output.task_id;
+}
+
+/**
+ * Query the status of an image generation task
+ */
+async function queryTaskStatus(taskId: string, apiKey: string): Promise<QwenImageTaskResponse> {
+  const endpoint = `https://dashscope.aliyuncs.com/api/v1/tasks/${taskId}`;
+
+  log('Querying task status for: %s', taskId);
+
+  const response = await fetch(endpoint, {
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+    },
+  });
+
+  if (!response.ok) {
+    let errorData;
+    try {
+      errorData = await response.json();
+    } catch {
+      // Failed to parse JSON error response
+    }
+    throw new Error(
+      `Failed to query task status (${response.status}): ${errorData?.message || response.statusText}`,
+    );
+  }
+
+  return response.json();
+}
+
+/**
+ * Create image using Qwen Wanxiang API
+ * This implementation uses async task creation and polling
+ */
+export async function createQwenImage(
+  payload: CreateImagePayload,
+  options: CreateImageOptions,
+): Promise<CreateImageResponse> {
+  const { apiKey, provider } = options;
+  try {
+    // 1. Create image generation task
+    const taskId = await createImageTask(payload, apiKey);
+
+    // 2. Poll task status until completion
+    let taskStatus: QwenImageTaskResponse | null = null;
+    let retries = 0;
+    let consecutiveFailures = 0;
+    const maxConsecutiveFailures = 3; // Allow up to 3 consecutive query failures
+    // Using Infinity for maxRetries is safe because:
+    // 1. Vercel runtime has execution time limits
+    // 2. Qwen's API will eventually return FAILED status for timed-out tasks
+    // 3. Our exponential backoff ensures reasonable retry intervals
+    const maxRetries = Infinity;
+    const initialRetryInterval = 500; // 500ms initial interval
+    const maxRetryInterval = 5000; // 5 seconds max interval
+    const backoffMultiplier = 1.5; // exponential backoff multiplier
+
+    while (retries < maxRetries) {
+      try {
+        taskStatus = await queryTaskStatus(taskId, apiKey);
+        consecutiveFailures = 0; // Reset consecutive failures on success
+      } catch (error) {
+        consecutiveFailures++;
+        log(
+          'Failed to query task status (attempt %d/%d, consecutive failures: %d/%d): %O',
+          retries + 1,
+          maxRetries,
+          consecutiveFailures,
+          maxConsecutiveFailures,
+          error,
+        );
+
+        // If we've failed too many times in a row, give up
+        if (consecutiveFailures >= maxConsecutiveFailures) {
+          throw new Error(
+            `Failed to query task status after ${consecutiveFailures} consecutive attempts: ${error}`,
+          );
+        }
+
+        // Wait before retrying
+        const currentRetryInterval = Math.min(
+          initialRetryInterval * Math.pow(backoffMultiplier, retries),
+          maxRetryInterval,
+        );
+        await new Promise((resolve) => {
+          setTimeout(resolve, currentRetryInterval);
+        });
+        retries++;
+        continue; // Skip the rest of the loop and retry
+      }
+
+      // At this point, taskStatus should not be null since we just got it successfully
+      log(
+        'Task %s status: %s (attempt %d/%d)',
+        taskId,
+        taskStatus!.output.task_status,
+        retries + 1,
+        maxRetries,
+      );
+
+      if (taskStatus!.output.task_status === 'SUCCEEDED') {
+        if (!taskStatus!.output.results || taskStatus!.output.results.length === 0) {
+          throw new Error('Task succeeded but no images generated');
+        }
+
+        // Return the first generated image
+        const imageUrl = taskStatus!.output.results[0].url;
+        log('Image generated successfully: %s', imageUrl);
+
+        return { imageUrl };
+      } else if (taskStatus!.output.task_status === 'FAILED') {
+        throw new Error(taskStatus!.output.error_message || 'Image generation task failed');
+      }
+
+      // Calculate dynamic retry interval with exponential backoff
+      const currentRetryInterval = Math.min(
+        initialRetryInterval * Math.pow(backoffMultiplier, retries),
+        maxRetryInterval,
+      );
+
+      log('Waiting %dms before next retry', currentRetryInterval);
+
+      // Wait before retrying
+      await new Promise((resolve) => {
+        setTimeout(resolve, currentRetryInterval);
+      });
+      retries++;
+    }
+
+    throw new Error(`Image generation timeout after ${maxRetries} attempts`);
+  } catch (error) {
+    log('Error in createQwenImage: %O', error);
+
+    throw AgentRuntimeError.createImage({
+      error: error as any,
+      errorType: 'ProviderBizError',
+      provider,
+    });
+  }
+}

package/src/libs/model-runtime/qwen/index.ts

@@ -2,6 +2,7 @@ import { ModelProvider } from '../types';
 import { processMultiProviderModelList } from '../utils/modelParse';
 import { createOpenAICompatibleRuntime } from '../utils/openaiCompatibleFactory';
 import { QwenAIStream } from '../utils/streams';
+import { createQwenImage } from './createImage';
 
 export interface QwenModelCard {
   id: string;
@@ -73,6 +74,7 @@ export const LobeQwenAI = createOpenAICompatibleRuntime({
     },
     handleStream: QwenAIStream,
   },
+  createImage: createQwenImage,
   debug: {
     chatCompletion: () => process.env.DEBUG_QWEN_CHAT_COMPLETION === '1',
   },

package/src/libs/model-runtime/utils/openaiCompatibleFactory/index.ts

@@ -52,6 +52,10 @@ export const CHAT_MODELS_BLOCK_LIST = [
 ];
 
 type ConstructorOptions<T extends Record<string, any> = any> = ClientOptions & T;
+export type CreateImageOptions = Omit<ClientOptions, 'apiKey'> & {
+  apiKey: string;
+  provider: string;
+};
 
 export interface CustomClientOptions<T extends Record<string, any> = any> {
   createChatCompletionStream?: (
@@ -89,7 +93,10 @@ interface OpenAICompatibleFactoryOptions<T extends Record<string, any> = any> {
     noUserId?: boolean;
   };
   constructorOptions?: ConstructorOptions<T>;
-  createImage?: (payload: CreateImagePayload & { client: OpenAI }) => Promise<CreateImageResponse>;
+  createImage?: (
+    payload: CreateImagePayload,
+    options: CreateImageOptions,
+  ) => Promise<CreateImageResponse>;
   customClient?: CustomClientOptions<T>;
   debug?: {
     chatCompletion: () => boolean;
@@ -178,6 +185,7 @@ export const createOpenAICompatibleRuntime = <T extends Record<string, any> = an
   models,
   customClient,
   responses,
+  createImage: customCreateImage,
 }: OpenAICompatibleFactoryOptions<T>) => {
   const ErrorType = {
     bizError: errorType?.bizError || AgentRuntimeErrorType.ProviderBizError,
@@ -317,6 +325,16 @@ export const createOpenAICompatibleRuntime = <T extends Record<string, any> = an
     }
 
     async createImage(payload: CreateImagePayload) {
+      // If custom createImage implementation is provided, use it
+      if (customCreateImage) {
+        return customCreateImage(payload, {
+          ...this._options,
+          apiKey: this._options.apiKey!,
+          provider,
+        });
+      }
+
+      // Otherwise use default OpenAI compatible implementation
       const { model, params } = payload;
       const log = createDebug(`lobe-image:model-runtime`);