阿里图像生成

使用阿里百炼 / DashScope 图像生成格式创建图像。该接口的请求体按阿里官方 model、input.messages、parameters 结构填写，平台仅提供统一入口、鉴权、模型路由和计费。

支持模型

该接口仅用于 阿里百炼 / DashScope 图像生成或图像编辑模型，并且只会路由到平台配置的阿里通道。当前按以下官方模型族编写示例：

模型 / 模型族	用途	说明
`qwen-image-2.0-pro`、`qwen-image-2.0`	千问文生图	使用 `messages[].content[].text` 传入提示词
`qwen-image-max`、`qwen-image-plus`、`qwen-image`	千问文生图	使用 `messages[].content[].text` 传入提示词
`wan2.6-image`	万相图像生成与编辑	使用 `messages[].content[]` 中的 `text` 和可选 `image`

不属于阿里百炼 / DashScope 的图片模型，例如 OpenAI、火山 Seedream、Gemini 等，请使用对应格式的图片接口，不要调用本接口。

Try It

POST/aliyun/v1/images/generationshttps://api-platform.ope.ai

认证

使用 Bearer Token 认证。

Header：Authorization: Bearer <token>
示例：Authorization: Bearer sk-xxxxxx

请求体（application/json）

字段	类型	必填	说明	默认值 / 范围
`model`	string	是	阿里百炼 / DashScope 图像模型 ID，平台会按渠道配置做模型映射	例如：`qwen-image-2.0-pro`、`qwen-image`、`wan2.6-image`
`input`	object	是	图像生成输入	-
`parameters`	object	否	生成参数	-

input

字段	类型	必填	说明
`messages`	array<object>	是	请求内容数组。按阿里官方文档，当前仅支持单轮对话

messages

字段	类型	必填	说明
`role`	string	是	固定为 `user`
`content`	array<object>	是	消息内容数组

content

字段	类型	必填	说明
`text`	string	是	正向提示词。Qwen-Image 文生图与 Wan2.6 Image 均按官方文档在 `content` 中传一个 `text` 对象
`image`	string	否	Wan2.6 Image 图像编辑参考图，按阿里官方支持的图片格式传入

parameters

字段	类型	必填	说明	默认值 / 范围
`size`	string	否	输出尺寸，按阿里官方格式使用 `宽高`，例如 `20482048`、`1280*1280`；Wan2.6 Image 也支持 `1K`、`2K` 档位	按模型官方默认值
`n`	integer	否	输出图像数量	按模型官方限制
`negative_prompt`	string	否	反向提示词	-
`prompt_extend`	boolean	否	是否开启 Prompt 智能改写	按模型官方默认值
`watermark`	boolean	否	是否添加水印	按模型官方默认值
`seed`	integer	否	Qwen-Image 随机数种子	`0` 至 `2147483647`
`enable_interleave`	boolean	否	Wan2.6 Image 图文混排输出模式开关	`false`
`max_images`	integer	否	Wan2.6 Image 图文混排模式下的生成图片数量上限	按模型官方限制
`stream`	boolean	否	Wan2.6 Image 图文混排同步调用时需配合流式输出	按官方要求使用

请求示例

下方域名为示例：https://api-platform.ope.ai。

cURL
JavaScript
Python
参考图

curl -X POST "https://api-platform.ope.ai/aliyun/v1/images/generations" \
  -H "Authorization: Bearer $OPEAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0-pro",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "text": "一只坐在极简书桌旁的白色机械猫，电影感光照，高清细节。"
            }
          ]
        }
      ]
    },
    "parameters": {
      "size": "2048*2048",
      "n": 1,
      "prompt_extend": true,
      "watermark": false
    }
  }'

const apiKey = process.env.OPEAI_API_KEY;

const res = await fetch("https://api-platform.ope.ai/aliyun/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen-image-2.0-pro",
    input: {
      messages: [
        {
          role: "user",
          content: [
            {
              text: "一只坐在极简书桌旁的白色机械猫，电影感光照，高清细节。",
            },
          ],
        },
      ],
    },
    parameters: {
      size: "2048*2048",
      n: 1,
      prompt_extend: true,
      watermark: false,
    },
  }),
});

console.log(await res.json());

import os
import requests

resp = requests.post(
  "https://api-platform.ope.ai/aliyun/v1/images/generations",
  headers={
    "Authorization": f"Bearer {os.environ.get('OPEAI_API_KEY')}",
    "Content-Type": "application/json",
  },
  json={
    "model": "qwen-image-2.0-pro",
    "input": {
      "messages": [
        {
          "role": "user",
          "content": [
            {
              "text": "一只坐在极简书桌旁的白色机械猫，电影感光照，高清细节。",
            },
          ],
        },
      ],
    },
    "parameters": {
      "size": "2048*2048",
      "n": 1,
      "prompt_extend": True,
      "watermark": False,
    },
  },
  timeout=120,
)

print(resp.json())

{
  "model": "wan2.6-image",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "参考这张产品图，生成一张干净的电商主图。"
          },
          {
            "type": "image",
            "image": "https://example.com/reference.png"
          }
        ]
      }
    ]
  },
  "parameters": {
    "size": "1K",
    "prompt_extend": true,
    "enable_interleave": false,
    "n": 1
  }
}

响应示例

平台会透传阿里上游响应体。成功响应通常包含 output.choices[]；平台会用上游响应中的图片数量完成计费。

成功
错误

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://dashscope-result.example.com/generated-image.png"
            }
          ]
        }
      }
    ]
  },
  "usage": {
    "image_count": 1,
    "width": 2048,
    "height": 2048
  },
  "request_id": "8f0b9c7a-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

{
  "error": {
    "message": "only aliyun channel is supported on /aliyun/v1/images/generations",
    "type": "invalid_request_error",
    "code": "invalid_request"
  }
}

说明

该接口只支持阿里百炼 / DashScope 图像模型，并且只支持路由到阿里通道；如果模型没有匹配到阿里通道，平台会返回错误。
请求字段、取值范围、图片输入限制与返回结构请以阿里官方对应模型文档为准。

支持模型​

Try It​

认证​

请求体（application/json）​

input​

messages​

content​

parameters​

请求示例​

响应示例​

说明​