Appearance
图片生成 Images
POST /api/v1/images
POST /api/v1/images/generations
Authorization: Bearer sk-xxx
Content-Type: application/json兼容 OpenAI 的图片生成接口。支持万象(Wan)系列和 Qwen 系列图片模型。
💡 两个路径完全等价,任选其一即可。图片生成为同步接口,
qwen-image-3.x-pro等模型单张生成可能耗时 1 分钟以上,请适当调大客户端超时(建议 ≥ 5 分钟)。
Request
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | * | 模型 ID,如 qwen-image-3.0-pro、qwen-image-3.0、wan2.7-image-pro、qwen-image-2.0 |
| prompt | string | * | 图片描述文本 |
| n | integer | 可选 | 生成图片数量,默认 1 |
| size | string | 可选 | 图片尺寸,如 1024x1024、1024x2048、2048x1024 |
| image_urls | array | 可选 | 参考图片 URL 列表(图生图,推荐) |
| image_url | string | 可选 | 单张参考图片 URL(图生图,兼容写法) |
💡
image_urls和image_url二选一,同时传入时image_urls优先。
常用图片模型:
| 模型 | 说明 | 单价(元/张) |
|---|---|---|
qwen-image-3.0-pro | Qwen Image 3.0 旗舰版,质量最高,生成耗时较长(可达 1 分钟以上) | 0.25 |
qwen-image-3.0 | Qwen Image 3.0 标准版 | 0.18 |
wan2.7-image-pro | 万象 2.7 旗舰版,支持图生图/多图参考 | 0.50 |
wan2.7-image | 万象 2.7 标准版 | 0.20 |
qwen-image-2.0-pro | Qwen Image 2.0 旗舰版 | 0.50 |
qwen-image-2.0 | Qwen Image 2.0 标准版 | 0.20 |
💡 实际扣费可能因组织/租户折扣低于上表单价,以账单为准。完整模型列表可通过
GET /api/v1/models查询。
文生图示例:
json
{
"model": "qwen-image-3.0-pro",
"prompt": "一只可爱的猫咪坐在窗台上,阳光洒在它身上",
"n": 1,
"size": "1024x1024"
}文生图示例(万象系列):
json
{
"model": "wan2.7-image-pro",
"prompt": "一只可爱的猫咪坐在窗台上,阳光洒在它身上",
"n": 1,
"size": "1024x1024"
}图生图示例(多张参考图):
json
{
"model": "wan2.7-image-pro",
"prompt": "生成类似风格的图片",
"image_urls": ["https://example.com/ref1.jpg", "https://example.com/ref2.jpg"],
"n": 1,
"size": "1024x1024"
}图生图示例(单张参考图):
json
{
"model": "wan2.7-image-pro",
"prompt": "基于此图生成新图",
"image_url": "https://example.com/ref.jpg",
"n": 1,
"size": "1024x1024"
}Response
json
{
"created": 1700000000,
"data": [
{
"url": "https://dashscope-result.oss-cn-xxx.aliyuncs.com/xxx.png"
}
]
}⚠️ 返回的图片 URL 为上游 OSS 临时链接(通常 24 小时内有效),请及时下载保存。
代码示例
bash
curl https://limapi.com/api/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxx" \
-d '{
"model": "qwen-image-3.0-pro",
"prompt": "一只可爱的猫咪坐在窗台上,阳光洒在它身上",
"n": 1,
"size": "1024x1024"
}'python
from openai import OpenAI
client = OpenAI(
base_url="https://limapi.com/api/v1",
api_key="sk-xxx",
timeout=300, # 图片生成耗时较长,建议 5 分钟超时
)
result = client.images.generate(
model="qwen-image-3.0-pro",
prompt="一只可爱的猫咪坐在窗台上,阳光洒在它身上",
size="1024x1024",
)
print(result.data[0].url)