docs: 添加图像生成API详细模型参数文档

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

包含:输入参数表、可用模型列表、响应示例
This commit is contained in:
yumoqing 2026-05-31 12:28:10 +08:00
parent 915b77cab7
commit 84817a6805

View File

@ -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
}
}
}
```
---
#### 智谱CogViewZhipu
##### 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 ## GET /v1/tasks