From 84817a6805c46015c545bbdad61b28cd0ac56caf Mon Sep 17 00:00:00 2001
From: yumoqing <yumoqing@gmail.com>
Date: Sun, 31 May 2026 12:28:10 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E5=9B=BE=E5=83=8F?=
 =?UTF-8?q?=E7=94=9F=E6=88=90API=E8=AF=A6=E7=BB=86=E6=A8=A1=E5=9E=8B?=
 =?UTF-8?q?=E5=8F=82=E6=95=B0=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

补充 POST /v1/image/generations 接口的4个生图模型详细参数说明：
- 百炼万象系列（wan2.2-t2i-plus, wan2.5-t2i-preview, wan2.2-t2i-flash）- 异步模式
- 智谱CogView（cogview-3-flash）- 同步模式

包含：输入参数表、可用模型列表、响应示例
---
 wwwroot/api_doc.md | 92 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)

diff --git a/wwwroot/api_doc.md b/wwwroot/api_doc.md
index 2cc64b5..af83487 100644
--- a/wwwroot/api_doc.md
+++ b/wwwroot/api_doc.md
@@ -425,6 +425,98 @@ data: [DONE]
 }
 ```
 
+### 各模型输入参数明细
+
+> 以下为各平台/模型的具体输入参数。调用时通过 `model` + `catelogid` 自动路由到对应供应商。
+
+---
+
+#### 百炼-万象文生图（DashScope）
+
+##### T2I - 文生图
+
+**异步模型**（需通过 `/v1/tasks?taskid=xxx` 查询状态）：
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 | 可选值 |
+|--------|------|------|--------|------|--------|
+| `model` | string | 是 | - | 模型名称 | 见下方模型列表 |
+| `prompt` | string | 是 | - | 提示词 | - |
+| `size` | string | 否 | `1024*1024` | 图像尺寸 | `512*512`, `1024*1024`, `2048*2048` 等 |
+| `n` | integer | 否 | `1` | 生成数量 | 1-4 |
+
+**可用模型：**
+
+| 模型名称 | 说明 | 查询周期 |
+|----------|------|----------|
+| `wan2.2-t2i-plus` | 万象专业版，在创意性、稳定性、写实质感上全面升级，生成细节丰富 | 10秒 |
+| `wan2.5-t2i-preview` | 万象2.5 preview版，在创意性、稳定性、写实质感上全面升级，生成细节丰富 | 10秒 |
+| `wan2.2-t2i-flash` | 万象极速版，快速生成，适合对速度要求高的场景 | 10秒 |
+
+**响应示例（异步提交）：**
+
+```json
+{
+    "status": "ok",
+    "data": {
+        "taskid": "task_xxx",
+        "status": "PENDING"
+    }
+}
+```
+
+**查询任务状态（`/v1/tasks?taskid=task_xxx`）：**
+
+```json
+{
+    "status": "ok",
+    "data": {
+        "status": "SUCCEEDED",
+        "output": [
+            {
+                "url": "https://..."
+            }
+        ],
+        "usage": {
+            "image_count": 1
+        }
+    }
+}
+```
+
+---
+
+#### 智谱CogView（Zhipu）
+
+##### T2I - 文生图
+
+**同步模型**（直接返回图像数据）：
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 | 可选值 |
+|--------|------|------|--------|------|--------|
+| `model` | string | 是 | `cogview-3-flash` | 模型名称 | `cogview-3-flash` |
+| `prompt` | string | 是 | - | 提示词 | - |
+| `size` | string | 否 | `1024x1024` | 图像尺寸 | `512x512`, `1024x1024`, `2048x2048` 等 |
+
+**可用模型：**
+
+| 模型名称 | 说明 |
+|----------|------|
+| `cogview-3-flash` | CogView-3-Flash是一款免费的图像生成模型，能够根据您的指令生成美学评分更高的图像。无论是艺术创作、设计参考还是娱乐用途，cogview-3-flash都能满足您的需求 |
+
+**响应示例（同步返回）：**
+
+```json
+{
+    "status": "ok",
+    "data": {
+        "image": "https://...",
+        "usage": {
+            "image_count": 1
+        }
+    }
+}
+```
+
 ---
 
 ## GET /v1/tasks