1. Images图片
MoYunAPI
  • MoYun API
    • 快速开始
    • 充值与价格说明
    • 接入Agent指南
      • IDE与终端AI(IDE & AI CLI)
        • VS Code配置指南
          • VS Code安装与配置指南
        • JetBrains系列配置指南
          • JetBrains系列IDE下载与安装
        • 国产桌面IDE配置指南
          • IDE 配接 Cline 使用指南
          • CodeBuddy CN IDE 配置指南
          • Trae CN IDE 配置指南
        • AI CLI配置指南
          • Kimi Code CLI
          • MiMo Code CLI 配置指南
          • OpenCode CLI 配置指南
          • Cursor CLI
          • Grok CLI
          • ChatGPT(Codex CLI)配置指南
          • Claude Code CLI配置指南
      • 桌面级Agent(Desktop Agent)
        • WorkBuddy 配置指南
        • QoderWork
        • ZCode配置指南
        • Claude Code Desktop
        • ChatGPT(Codex Desktop)配置指南
        • Grok Desktop配置指南
        • MiniMax Code配置指南
        • Cursor Desktop
        • OpenCode Desktop配置指南
      • 工作流(WorkFlows)
        • n8n 配置使用 MoYunAPI 教程
        • Dify 配置使用 MoYunAPI 教程
      • 自动化工具(Automation)
        • CC Switch 安装与配置教程
      • 开源项目(Open Source)
        • OpenClaw下载与API配接(Windows)
        • OpenClaw下载与API配接(Linux)
    • 提示词指南
      • Seedream 4.0-5.0 提示词指南
    • API 文档
      • Models模型
        • 获取模型列表
      • Chat对话
        • 对话补全 (Chat Completions) — 核心接口
      • Completions文本
        • 文本补全 (Completions)
      • Embeddings向量
        • 文本嵌入 (Embeddings)
      • Images图片
        • Doubao-Seedream 图生图(单图参考)
          POST
        • Doubao-Seedream 多图融合生图
          POST
        • Doubao-Seedream 文生图
          POST
        • Doubao-Seedream 组图生成
          POST
        • MiniMax-Image 文生图
          POST
        • MiniMax-Image 图生图(人物主体参考)
          POST
        • GLM-Image 文生图
          POST
        • GLM-CogView 文生图
          POST
        • Qwen-Image 文生图
          POST
        • Qwen-Image 3.0 图生图/图像编辑
          POST
      • Audio音频
        • MiMo-TTS语音系列
        • 语音合成 (Text-to-Speech)
        • 语音识别 (Audio Transcription)
      • Realtime语音对话
        • 实时语音对话 (WebSocket)
      • Moderations内容安全审核
        • 内容安全审核 (Moderations)
      • Rerank文档重排序
        • 文档重排序 (Rerank)
      • Video视频
        • 生成视频 (Video Generation, 异步任务)
        • 查询视频任务状态
    • Images图片
    • 数据模型
      • Error
      • ErrorResponse
      • Usage
      • StyleObject
      • ChatMessage
      • SubjectReference
      • Tool
      • FunctionCall
  1. Images图片

Qwen-Image 文生图

POST
https://moyunapi.com/v1/images/generations
Images图片

接口说明#

使用千问 Qwen-Image 系列模型,根据文本提示词生成高质量图片。擅长复杂文本渲染、写实人像、艺术风格等场景。
端点: POST /v1/images/generations
Base URL: https://moyunapi.com
认证: Authorization: Bearer sk-xxx
返回格式: 默认返回 URL(图片链接有效期 24 小时)

调用示例(Python / OpenAI SDK)#

模型推荐#

场景推荐模型说明
通用生图qwen-image-3.0最新 3.0 系列,兼顾质量与速度
最高质量qwen-image-3.0-pro3.0 Pro,效果最好
写实人像qwen-image-maxAI 痕迹最低,真实感最强
文字渲染qwen-image-2.0-pro文字渲染能力最强
快速生成qwen-image-2.0加速版,响应速度最快
艺术风格qwen-image-plus擅长多样化艺术风格

尺寸说明#

3.0 系列(qwen-image-3.0 / qwen-image-3.0-pro)#

像素范围:512x512 ~ 2048x2048
宽高比限制:1:8 ~ 8:1
不指定 size 时由模型自动推荐分辨率
格式:宽x高(如 1024x1024)

2.0 系列(qwen-image-2.0-pro / qwen-image-2.0)#

尺寸宽高比说明
2048x20481:1默认值
2688x153616:9宽屏横图
1536x26889:16手机竖屏
2368x17284:3标准横图
1728x23683:4标准竖图

Max / Plus 系列#

尺寸宽高比说明
1664x92816:9默认值
1328x13281:1正方形
1472x11044:3标准横图
1104x14723:4标准竖图
928x16649:16手机竖屏

参数说明#

参数类型必填传递方式说明
modelstring是SDK 参数模型名称
promptstring是SDK 参数正向提示词,支持中英文
sizestring否SDK 参数图片尺寸,格式 宽x高
response_formatstring否SDK 参数url(默认)或 b64_json
ninteger否SDK 参数输出图片数量(1-6),max/plus 固定为 1
negative_promptstring否extra_body反向提示词
watermarkboolean否extra_body是否添加水印,默认 false
prompt_extendboolean否extra_body是否开启提示词智能改写,默认 true
prompt_extend_modestring否extra_body改写方式:direct(默认)/ agent
seedinteger否extra_body随机种子 [0, 2147483647]

prompt_extend_mode 说明#

值说明适用场景
direct直接提示词增强(DPE),默认值T2I 和 I2I 均支持
agent智能体提示词增强(APE),更精细仅 T2I 支持,I2I 传入会报错

注意事项#

图片 URL 有效期 24 小时,请及时下载保存。
qwen-image-max 和 qwen-image-plus 的 n 参数固定为 1,设置其他值会报错。
2.0 系列提示词长度上限 1300 Token,其他模型 800 Token(3.0 系列推荐不超过 4500 Token)。
negative_prompt 长度不超过 500 字符。
prompt_extend 开启后模型会优化提示词,适合简单描述;关闭后提示词更可控。

参考文档#

千问-文生图 API 参考
千问-图像生成与编辑 3.0 API 参考

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Header 参数

Body 参数application/json必填

示例

返回响应

🟢200
application/json
成功生成图片
Bodyapplication/json

🟠400
🟠401
🟠429
🔴500
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://moyunapi.com/v1/images/generations' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "qwen-image-3.0",
    "prompt": "一只可爱的小猫咪,坐在阳光明媚的房间窗台上,背景是花草树木与蓝天白云.",
    "size": "1024x1024",
    "response_format": "url",
    "n": 1,
    "negative_prompt": "低分辨率,低画质,肢体畸形,手指畸形,画面过饱和,蜡像感",
    "watermark": false,
    "prompt_extend": true,
    "seed": 42
}'
响应示例响应示例
200 - URL 格式响应(默认)
{
    "created": 1786523061,
    "data": [
        {
            "url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/34/20260812/a8b27c95/9af528d4-efd4-95ae-9e1b-ba7bc74340d7_qwen_image3_serving_output_0.png?Expires=1786609507&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=AEaesMlAjVXiFt43DIm3QreD5Lo%3D"
        }
    ],
    "usage": {
        "input_image_count": 0,
        "input_image_type": "qima_input_1k",
        "output_height": 1024,
        "output_image_count": 1,
        "output_image_type": "qima_output_1k",
        "output_width": 1024
    }
}
上一页
GLM-CogView 文生图
下一页
Qwen-Image 3.0 图生图/图像编辑
Built with