Skip to main content

​
千问图片生成示例

以下示例展示如何使用千问 API 生成高质量的图片和进行图片编辑。

​
快速开始

curl -X POST "https://model-api.skyengine.com.cn/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "prompt": "一只可爱的小猫在花园里玩耍，阳光明媚，油画风格",
    "model": "qwen-image-plus",
    "size": "1328*1328",
    "n": 1,
    "response_format": "url",
    "qwen": {
      "prompt_extend": true,
      "negative_prompt": "低分辨率、错误、最差质量"
    }
  }'

​
重要提示

千问图片生成模型限制：
  • 目前不支持流式输出
  • n 参数限制：
    • qwen-image-edit-plus、qwen-image-edit-plus-2025-10-30：可选择输出1-6张图片
    • qwen-image-edit：仅支持输出1张图片
    • 其他模型（如qwen-image-plus等）：固定输出1张图片
  • 随机数种子范围：[0,2147483647]
  • 尺寸限制：只支持特定尺寸，必须使用星号(*)作为分隔符，不能使用x
千问专用功能：
  • prompt_extend 智能改写功能可显著提升生成质量，建议开启
  • negative_prompt 反向提示词有效控制不想要的元素
  • 支持多种分辨率比例，适应不同应用场景

​
支持的参数

​
基础参数

  • prompt: 图片描述文本（必需）
  • model: 模型名称，推荐 qwen-image-plus（更优惠），也支持 qwen-image
  • n: 输出图像的数量，默认值为1
    • qwen-image-edit-plus、qwen-image-edit-plus-2025-10-30：可选择输出1-6张图片
    • qwen-image-edit：仅支持输出1张图片
    • 其他模型：固定输出1张图片
  • size: 图片尺寸，必须精确匹配以下允许的尺寸：
    • 1664*928 (16:9) - 注意使用星号分隔符
    • 1472*1140 (4:3) - 注意使用星号分隔符
    • 1328*1328 (1:1，默认) - 注意使用星号分隔符
    • 1140*1472 (3:4) - 注意使用星号分隔符
    • 928*1664 (9:16) - 注意使用星号分隔符
  • response_format: 返回格式（url 或 b64_json）

​
千问专用参数

  • qwen.prompt_extend: 是否开启智能改写，默认 true
  • qwen.negative_prompt: 反向提示词，长度不超过500字符

​
其他参数

  • seed: 随机数种子，范围[0,2147483647]
  • watermark: 是否添加水印，默认 false

​
图片编辑示例

千问支持基于现有图片进行编辑和多图融合： 
curl -X POST "https://model-api.skyengine.com.cn/v1/images/edits" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "prompt": "生成一张符合深度图的图像，遵循以下描述：一辆红色的破旧的自行车停在一条泥泞的小路上，背景是茂密的原始森林",
    "model": "qwen-image-edit-plus",
    "size": "1328*1328",
    "image": [
      "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
    ],
    "n": 1,
    "response_format": "url",
    "qwen": {
      "prompt_extend": true,
      "negative_prompt": "低分辨率、错误、最差质量",
      "watermark": false
    }
  }'

​
响应格式

千问API的响应格式如下： 
{
  "created": 1764820175,
  "data": [
    {
      "url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/7d/e2/20251204/76c577f4/a56bad48-aa1a-4fba-a90c-a449089df5cf-1.png?Expires=1765425974&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=kdS4TW23LsCOdFf2tqFCIYNQGMg%3D"
    }
  ],
  "usage": {
    "total_tokens": 1,
    "output_tokens": 1,
    "input_tokens_details": {}
  }
}