From 067b1003e3f3049a4fb50eb0ed1d01a304e6d566 Mon Sep 17 00:00:00 2001
From: yumoqing <yumoqing@gmail.com>
Date: Tue, 2 Jun 2026 16:36:13 +0800
Subject: [PATCH] docs: fix image/generations general response example to match
 actual UAPI response

---
 wwwroot/api_doc.html | 31 ++++++++++++++++++++++++-------
 wwwroot/api_doc.md   | 35 ++++++++++++++++++++++++++++-------
 2 files changed, 52 insertions(+), 14 deletions(-)

diff --git a/wwwroot/api_doc.html b/wwwroot/api_doc.html
index 516beb0..d619a2e 100644
--- a/wwwroot/api_doc.html
+++ b/wwwroot/api_doc.html
@@ -396,15 +396,32 @@ data: [DONE]`
         },
         responseExamples: [
           {
-            title: "响应示例",
+            title: "成功响应（同步）",
             lang: "json",
             code: `{
-    "id": "luid_xxx",
-    "object": "image.generation",
-    "model": "qwen-image-2.0-pro",
-    "status": "submitted",
-    "taskid": "task_xxx",
-    "created": 1716912000
+    "status": "SUCCEEDED",
+    "usage": {"image_count": 1},
+    "image_count": 1,
+    "image": ["https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/1d/...png"]
+}`
+          },
+          {
+            title: "失败响应",
+            lang: "json",
+            code: `{
+    "status": "FAILED",
+    "error": "InvalidParameter.InvalidParameter"
+}`
+          },
+          {
+            title: "异步模型提交",
+            lang: "json",
+            code: `{
+    "status": "ok",
+    "data": {
+        "taskid": "task_xxx",
+        "status": "PENDING"
+    }
 }`
           }
         ],
diff --git a/wwwroot/api_doc.md b/wwwroot/api_doc.md
index 75947cc..a26a547 100644
--- a/wwwroot/api_doc.md
+++ b/wwwroot/api_doc.md
@@ -412,16 +412,37 @@ data: [DONE]
 
 ### 响应格式
 
-响应格式取决于上游模型配置（同步返回图像数据，异步返回任务信息）：
+同步模型直接返回图像数据，异步模型返回任务信息。
+
+**成功响应（以 wan2.7-image-pro 为例）：**
 
 ```json
 {
-    "id": "luid_xxx",
-    "object": "image.generation",
-    "model": "qwen-image-2.0-pro",
-    "status": "submitted",
-    "taskid": "task_xxx",
-    "created": 1716912000
+    "status": "SUCCEEDED",
+    "usage": {"image_count": 1},
+    "image_count": 1,
+    "image": ["https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/1d/...png"]
+}
+```
+
+**失败响应：**
+
+```json
+{
+    "status": "FAILED",
+    "error": "InvalidParameter.InvalidParameter"
+}
+```
+
+**异步模型提交响应：**
+
+```json
+{
+    "status": "ok",
+    "data": {
+        "taskid": "task_xxx",
+        "status": "PENDING"
+    }
 }
 ```