From 4ac95125d7d12ed1acec543449fb36312a0fd5b6 Mon Sep 17 00:00:00 2001
From: yumoqing <yumoqing@gmail.com>
Date: Tue, 2 Jun 2026 16:25:17 +0800
Subject: [PATCH] docs: fix image generation response format - remove outer
 wrapper, use direct UAPI response

---
 wwwroot/api_doc.html | 14 +++++++-------
 wwwroot/api_doc.md   | 42 +++++++++++++++---------------------------
 2 files changed, 22 insertions(+), 34 deletions(-)

diff --git a/wwwroot/api_doc.html b/wwwroot/api_doc.html
index 3742878..516beb0 100644
--- a/wwwroot/api_doc.html
+++ b/wwwroot/api_doc.html
@@ -410,7 +410,7 @@ data: [DONE]`
         ],
         models: [
           {
-            name: "万象图像 wan2.7 系列（异步）",
+            name: "万象图像 wan2.7 系列（同步）",
             params: [
               { name: "model", type: "string", required: true, desc: "wan2.7-image-pro / wan2.7-image-plus" },
               { name: "catelogid", type: "string", required: true, desc: "文生图固定 t2i" },
@@ -420,11 +420,11 @@ data: [DONE]`
             ],
             responseExample: {
               lang: "json",
-              code: `// 提交响应
-{"status": "ok", "data": {"taskid": "task_xxx", "status": "PENDING"}}
+              code: `// 成功响应
+{"status": "SUCCEEDED", "usage": {"image_count": 1}, "image_count": 1, "image": ["https://..."]}
 
-// 查询结果（/v1/tasks?taskid=task_xxx）
-{"status": "ok", "data": {"status": "SUCCEEDED", "usage": {"image_count": 1}, "image_count": 1, "image": ["https://..."]}}`
+// 失败响应
+{"status": "FAILED", "error": "InvalidParameter.InvalidParameter"}`
             }
           },
           {
@@ -442,10 +442,10 @@ data: [DONE]`
             responseExample: {
               lang: "json",
               code: `// 成功响应
-{"status": "ok", "data": {"status": "SUCCEEDED", "usage": {"image_count": 1}, "image_count": 1, "image": ["https://..."]}}
+{"status": "SUCCEEDED", "usage": {"image_count": 1}, "image_count": 1, "image": ["https://..."]}
 
 // 失败响应
-{"status": "ok", "data": {"status": "FAILED", "error": "InvalidParameter.InvalidParameter"}}`
+{"status": "FAILED", "error": "InvalidParameter.InvalidParameter"}`
             }
           },
           {
diff --git a/wwwroot/api_doc.md b/wwwroot/api_doc.md
index c12745a..75947cc 100644
--- a/wwwroot/api_doc.md
+++ b/wwwroot/api_doc.md
@@ -435,7 +435,7 @@ data: [DONE]
 
 ##### T2I - 文生图
 
-**异步模型**（需通过 `/v1/tasks?taskid=xxx` 查询状态）：
+**同步模型**（直接返回图像数据）：
 
 | 参数名 | 类型 | 必填 | 默认值 | 说明 | 可选值 |
 |--------|------|------|--------|------|--------|
@@ -452,29 +452,23 @@ data: [DONE]
 | `wan2.7-image-pro` | 万象专业版，创意性、稳定性、写实质感全面升级 | 0.5元/张 |
 | `wan2.7-image-plus` | 万象Plus版，高分辨率图像生成，性价比高 | 0.2元/张 |
 
-**响应示例（异步提交）：**
+**成功响应示例：**
 
 ```json
 {
-    "status": "ok",
-    "data": {
-        "taskid": "task_xxx",
-        "status": "PENDING"
-    }
+    "status": "SUCCEEDED",
+    "usage": {"image_count": 1},
+    "image_count": 1,
+    "image": ["https://..."]
 }
 ```
 
-**查询任务状态（`/v1/tasks?taskid=task_xxx`）：**
+**失败响应示例：**
 
 ```json
 {
-    "status": "ok",
-    "data": {
-        "status": "SUCCEEDED",
-        "usage": {"image_count": 1},
-        "image_count": 1,
-        "image": ["https://..."]
-    }
+    "status": "FAILED",
+    "error": "InvalidParameter.InvalidParameter"
 }
 ```
 
@@ -508,13 +502,10 @@ data: [DONE]
 
 ```json
 {
-    "status": "ok",
-    "data": {
-        "status": "SUCCEEDED",
-        "usage": {"image_count": 1},
-        "image_count": 1,
-        "image": ["https://..."]
-    }
+    "status": "SUCCEEDED",
+    "usage": {"image_count": 1},
+    "image_count": 1,
+    "image": ["https://..."]
 }
 ```
 
@@ -522,11 +513,8 @@ data: [DONE]
 
 ```json
 {
-    "status": "ok",
-    "data": {
-        "status": "FAILED",
-        "error": "InvalidParameter.InvalidParameter"
-    }
+    "status": "FAILED",
+    "error": "InvalidParameter.InvalidParameter"
 }
 ```