Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-model.skyengine.com.cn/llms.txt

Use this file to discover all available pages before exploring further.

​
千问图片生成示例

以下示例展示如何使用千问 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": "1328x1328",
    "n": 1,
    "response_format": "url",
    "optimize_prompt_options": {
      "enable": 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 作为分隔符（如 1024x1024），系统会自动转换为千问要求的格式
千问专用功能：
  • optimize_prompt_options.enable 智能改写功能可显著提升生成质量，建议开启
  • optimize_prompt_options.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: 图片尺寸，使用 x 作为分隔符，必须精确匹配以下允许的尺寸：
    • 1664x928 (16:9)
    • 1472x1140 (4:3)
    • 1328x1328 (1:1，默认)
    • 1140x1472 (3:4)
    • 928x1664 (9:16)
  • response_format: 返回格式（url 或 b64_json）

​
千问专用参数

  • optimize_prompt_options.enable: 是否开启智能改写，默认 true
  • optimize_prompt_options.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": "1328x1328",
    "image": [
      "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp"
    ],
    "n": 1,
    "response_format": "url",
    "optimize_prompt_options": {
      "enable": 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": {}
  }
}