diff --git a/agents-flex-core/src/main/java/com/agentsflex/core/image/ImageResponse.java b/agents-flex-core/src/main/java/com/agentsflex/core/image/ImageResponse.java
new file mode 100644
index 0000000..5dcabe7
--- /dev/null
+++ b/agents-flex-core/src/main/java/com/agentsflex/core/image/ImageResponse.java
@@ -0,0 +1,87 @@
+/*
+ *  Copyright (c) 2023-2025, Agents-Flex (fuhai999@gmail.com).
+ *  <p>
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *  <p>
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *  <p>
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+package com.agentsflex.core.image;
+
+import com.agentsflex.core.util.Metadata;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+public class ImageResponse extends Metadata {
+    private List<Image> images;
+    private boolean error;
+    private String errorMessage;
+
+
+    public static ImageResponse error(String errMessage) {
+        ImageResponse imageResponse = new ImageResponse();
+        imageResponse.setError(true);
+        imageResponse.setErrorMessage(errMessage);
+        return imageResponse;
+    }
+
+    public List<Image> getImages() {
+        return images != null ? images : Collections.emptyList();
+    }
+
+    public void setImages(List<Image> images) {
+        this.images = images;
+    }
+
+
+    public void addImage(String url) {
+        if (this.images == null) {
+            this.images = new ArrayList<>();
+        }
+
+        this.images.add(Image.ofUrl(url));
+    }
+
+    public void addImage(byte[] bytes) {
+        if (this.images == null) {
+            this.images = new ArrayList<>();
+        }
+
+        this.images.add(Image.ofBytes(bytes));
+    }
+
+    public boolean isError() {
+        return error;
+    }
+
+    public void setError(boolean error) {
+        this.error = error;
+    }
+
+    public String getErrorMessage() {
+        return errorMessage;
+    }
+
+    public void setErrorMessage(String errorMessage) {
+        this.errorMessage = errorMessage;
+    }
+
+    @Override
+    public String toString() {
+        return "ImageResponse{" +
+            "images=" + images +
+            ", error=" + error +
+            ", errorMessage='" + errorMessage + '\'' +
+            ", metadataMap=" + metadataMap +
+            '}';
+    }
+}