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 3.0 图生图/图像编辑

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

接口说明#

使用千问 Qwen-Image 3.0 系列模型,基于 1-3 张参考图片 + 文本指令进行图像编辑或生成。仅 qwen-image-3.0-pro 和 qwen-image-3.0 支持。
端点: POST /v1/images/generations(与文生图相同端点)
Base URL: https://moyunapi.com
认证: Authorization: Bearer sk-xxx
返回格式: 默认返回 URL(图片链接有效期 24 小时)

功能说明#

传入 1-3 张参考图片 + 编辑指令,模型根据参考图片生成新图片:
人物换装、换场景、换风格
保持人物面部特征一致性
图像局部编辑(修改背景、添加/删除元素等)
多图元素融合

调用示例(Python / OpenAI SDK)#

单图编辑#

多图融合(最多 3 张)#

使用 Base64 编码图片#

image 参数说明#

image 参数支持以下格式:
格式说明示例
公网 URLHTTP/HTTPS 协议https://example.com/photo.jpg
Base64 编码data URI 格式data:image/jpeg;base64,/9j/4AAQ...
传入单张图片时,image 为字符串
传入多张图片时,image 为字符串数组(最多 3 张)
支持的图片格式:JPG、JPEG、PNG、BMP、TIFF、WEBP、GIF
图片分辨率建议:宽高均在 384px-2048px 之间
图片大小限制:不超过 10MB

尺寸说明#

像素范围:512x512 ~ 2048x2048
宽高比限制:1:8 ~ 8:1
不指定 size 时由模型根据参考图自动推荐分辨率

参数说明#

参数类型必填传递方式说明
modelstring是SDK 参数仅 qwen-image-3.0-pro / qwen-image-3.0
promptstring是SDK 参数编辑指令,描述期望的修改效果
imagestring/array是extra_body参考图片 URL 或 Base64(1-3 张)
sizestring否SDK 参数输出分辨率
response_formatstring否SDK 参数url(默认)或 b64_json
ninteger否SDK 参数输出图片数量(1-6)
negative_promptstring否extra_body反向提示词
watermarkboolean否extra_body是否添加水印
prompt_extendboolean否extra_body是否开启提示词改写
seedinteger否extra_body随机种子

注意事项#

仅 qwen-image-3.0-pro 和 qwen-image-3.0 支持图生图,其他模型会报错。
prompt_extend_mode 在 I2I 场景下仅支持 direct,传入 agent 会返回 400 错误。
图片 URL 有效期 24 小时,请及时下载保存。
参考图片的 URL 需要是公网可访问的地址。

参考文档#

千问-图像生成与编辑 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": "帮我把这张照片中的背景替换为海边日落场景,保持人物姿态不变",
    "image": "https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png",
    "size": "1024x1024",
    "response_format": "url",
    "n": 1,
    "watermark": false,
    "prompt_extend": true
}'
响应示例响应示例
200 - 单图编辑响应
{
    "created": 1786523061,
    "data": [
        {
            "url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/1d/34/20260812/a8b27c95/i2i_output_0.png?Expires=1786609507&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=xxx%3D"
        }
    ],
    "usage": {
        "input_image_count": 1,
        "input_image_type": "qima_input_1k",
        "output_height": 1024,
        "output_image_count": 1,
        "output_image_type": "qima_output_1k",
        "output_width": 1024
    }
}
上一页
Qwen-Image 文生图
下一页
MiMo-TTS语音系列
Built with