千问-图像生成与编辑

POST /api/v1/services/aigc/multimodal-generation/generation — qwen-image 同步生图

千问图像模型同时支持文生图（T2I）与图生图/图像编辑（I2I）：不传图为文生图，传入参考图 + 编辑指令为图生图。同步接口，一次请求直接返回结果。

支持的模型

模型	说明
`qwen-image-2.0-pro`	千问图像生成与编辑

创建请求

POST/api/v1/services/aigc/multimodal-generation/generation

curl https://api.modelsite.ai/api/v1/services/aigc/multimodal-generation/generation \
  -H "Authorization: Bearer $MODELSITE_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0-pro",
    "input": {
      "messages": [
        { "role": "user",
          "content": [{ "text": "一张竖幅人像摄影：午后街边报刊亭前的年轻女性，暖色胶片质感" }] }
      ]
    },
    "parameters": { "size": "1024*1024", "n": 1 }
  }'

请求体

字段	类型	说明
`model`	string（必填）	`qwen-image-2.0-pro`
`input.messages`	array（必填）	有且仅有一个对象：`{"role": "user", "content": [...]}`（仅支持单轮）
`input.messages[].content`	array（必填）	T2I：仅 1 个 `{"text": "..."}`。I2I：`{"image": "..."}`（URL 或 `data:` Base64）+ 1 个 `{"text": "..."}` 编辑指令，text 只能有 1 个
`parameters`	object（可选）	见下表

parameters 参数

参数	类型	说明
`size`	string	输出分辨率 `宽高`（星号分隔，如 `"10241024"`），或 `"auto"`（模型自荐）。像素面积 512512 ~ 20482048，宽高比 1:8 ~ 8:1
`n`	integer	输出张数 1-6，默认 1。必须传整数，传字符串 `"1"` 报 400
`prompt_extend`	boolean	提示词智能改写，默认 `true`（建议开启）
`negative_prompt`	string	反向提示词（按模型版本支持，以该模型实际支持为准）
`seed`	integer	`[0, 2147483647]`
`watermark`	boolean	水印，默认 `false`

部分模型还支持 prompt_extend_mode（direct/agent）与 enable_thinking（思考模式增强出图质量）——是否生效取决于你调用的模型版本，以 GET /v1/models 的模型详情与实测为准。

响应

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [{ "image": "https://.../generated.png" }]
        }
      }
    ]
  },
  "usage": {
    "output_width": 1024,
    "output_height": 1024,
    "input_image_count": 0,
    "output_image_count": 1
  },
  "request_id": "571ae02f-5c9d-436c-83c2-f221e6df0xxx"
}

字段	说明
`output.choices[].message.content[].image`	生成图像 URL（PNG）。链接有效期 24 小时，请立即下载转存
`usage.output_image_count`	实际返回的图片数——计费张数以它为准
`usage.output_width` / `output_height`	最终输出像素

计费

按成功生成的张数计费（usage.output_image_count），分辨率档位影响单价；请求失败不计费。单价见模型页。

错误处理

参数错误返回 4xx + {"code": "...", "message": "..."}（如 InvalidParameter）；上游处理失败同样以 code/message 回传。通用错误码见错误处理。

千问-图像生成与编辑

支持的模型

创建请求

响应

计费

错误处理

本页内容