La edición de Qwen-Image admite entrada y salida de múltiples imágenes. Edite texto dentro de imágenes, agregue, elimine o mueva objetos, cambie poses de sujetos, transfiera estilos y mejore detalles, todo a través de prompts en lenguaje natural.
Resumen de modelos
Imagen de entrada 1 | Imagen de entrada 2 | Imagen de entrada 3 | Imágenes de salida (múltiples) | |
|---|---|---|---|---|
![]() | ![]() | ![]() | ![]() | ![]() |
Prompt: La chica de la Imagen 1 lleva el vestido negro de la Imagen 2 y está sentada en la postura de la Imagen 3.
Nombre del modelo | Descripción del modelo | Especificaciones de la imagen de salida |
|---|---|---|
qwen-image-2.0-pro Actualmente tiene las mismas capacidades que qwen-image-2.0-pro-2026-04-22 | La serie Pro de modelos de generación y edición de imágenes Qwen ofrece capacidades mejoradas en renderizado de texto, texturas realistas y adherencia semántica. Para la generación de imágenes, consulte Qwen-Text a imagen. | Resolución de imagen:
Formato de imagen: png Número de imágenes: 1–6 |
qwen-image-2.0-pro-2026-06-22 | ||
qwen-image-2.0-pro-2026-04-22 | ||
qwen-image-2.0-pro-2026-03-03 | ||
qwen-image-2.0 Actualmente tiene las mismas capacidades que qwen-image-2.0-2026-03-03 | Esta es la versión acelerada del modelo de generación y edición de imágenes Qwen, que equilibra el rendimiento y la velocidad de respuesta. Para la generación de imágenes, consulte Qwen-Text a imagen. | |
qwen-image-2.0-2026-03-03 |
Requisitos previos
Antes de realizar una llamada, obtenga una clave de API y exporte la clave de API como variable de entorno.
Para llamar a la API mediante el SDK, instale el SDK de DashScope. El SDK está disponible para Python y Java.
Llamada HTTP
Región de Singapur:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Región de Pekín:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Al realizar la llamada, reemplace {WorkspaceId} con su ID de espacio de trabajo real.
Parámetros de solicitud |
Este ejemplo utiliza el modelo qwen-image-2.0-pro para generar dos imágenes. |
Encabezados de solicitud | |
Content-Type string (Requerido)El tipo de contenido de la solicitud. Debe ser application/json. | |
Authorization string (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx. | |
Cuerpo de la solicitud | |
model string (Obligatorio)El nombre del modelo. Ejemplo: qwen-image-2.0-pro. | |
input object (Obligatorio)El objeto de entrada, que contiene el siguiente campo:
Propiedad messages array (Obligatorio)La matriz de contenido de la solicitud. Actualmente solo se admiten conversaciones de un solo turno, por lo que la matriz debe contener exactamente un objeto con las propiedades role y content.
Propiedad role string (Obligatorio)El rol del remitente del mensaje. Debe ser user.contentarray (Obligatorio)El contenido del mensaje, que consta de una a tres imágenes en formato {"image": "..."} y una única instrucción de edición en formato {"text": "..."}.
Propiedad image string (Obligatorio)La URL o los datos codificados en Base64 de la imagen de entrada. Puede proporcionar de una a tres imágenes.Para entradas de múltiples imágenes, el orden de las imágenes se define por la secuencia de la matriz. La relación de aspecto de la imagen de salida se basa en la última imagen.Requisitos de imagen:
string(Obligatorio)Un prompt positivo que describe el contenido, estilo y composición deseados de la imagen de salida.Admite chino e inglés. La serie qwen-image-2.0 acepta hasta 1,300 tokens. El sistema trunca los tokens excedentes.Nota: El array content debe contener exactamente un objeto text. De lo contrario, se producirá un error. | |
parameters object (Opcional)Parámetros adicionales para controlar la generación de imágenes.
Propiedad n integer (Opcional)El número de imágenes de salida. Predeterminado: 1.Para los modelos de la serie qwen-image-2.0, puede elegir generar de una a seis imágenes.negative_prompt string (Opcional)Un prompt negativo que describe el contenido que se debe excluir de la salida. Úselo para restringir la generación.Admite chino e inglés. Máximo de 500 caracteres. Cada carácter chino, letra, número o símbolo cuenta como un carácter. Los caracteres excedentes se truncan automáticamente.Por ejemplo: baja resolución, error, peor calidad, baja calidad, desfigurado, dedos extra o malas proporciones.size string (Opcional)La resolución de la imagen de salida en formato width*height. Ejemplo: "1024*1536".Modelos de la serie qwen-image-2.0:
Si especifica el parámetro
Resoluciones recomendadas para relaciones de aspecto comunes
bool (Opcional)Habilita la reescritura inteligente de prompts. Valor predeterminado: true. Cuando está habilitado, el modelo optimiza el prompt positivo (text), mejorando significativamente los resultados para prompts simples.Modelos compatibles: Todos los modelos.watermark bool (Opcional)Añade una marca de agua "Qwen-Image" a la esquina inferior derecha. Predeterminado: false.seed integer (Opcional)La semilla de número aleatorio. Rango válido: [0, 2147483647].Establecer el mismo valor de seed ayuda a mantener una estabilidad relativa en la salida generada. Si se omite, el algoritmo utiliza una semilla aleatoria.Nota: La generación de imágenes es probabilística. Incluso con la misma seed, los resultados pueden variar entre llamadas. |
Parámetros de respuesta |
Los datos de la tarea (estado de la tarea y URL de imágenes) se conservan solo durante 24 horas y luego se eliminan automáticamente. Guarde las imágenes generadas con prontitud. |
output objectLos resultados de generación del modelo.
Propiedad choices arrayUna lista de opciones de resultados.
Propiedad finish_reason stringEl motivo por el que se detuvo la tarea. Devuelve stop para una detención natural.message objectEl mensaje devuelto por el modelo.
Propiedad role stringEl rol del mensaje. Fijo en assistant.contentarrayEl contenido del mensaje, que contiene la información de la imagen generada.
Propiedad imagen stringURL de la imagen generada en formato PNG. Válida durante 24 horas. Descargue y guarde la imagen rápidamente. | |
usage objectUso de recursos para esta llamada. Se devuelve solo en caso de éxito.
Propiedad image_count integerEl número de imágenes generadas.width integerEl ancho de la imagen generada en píxeles.height integerLa altura de la imagen generada en píxeles. | |
request_id stringIdentificador único de solicitud para rastreo y solución de problemas. | |
code stringCódigo de error. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error. | |
message stringMensaje de error detallado. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error. |
Llamada al SDK de DashScope
Los nombres de los parámetros del SDK son mayoritariamente consistentes con la API HTTP. La estructura de parámetros se encapsula según las características del lenguaje. Para obtener una lista completa de parámetros, consulte la referencia de la API de Qwen.
Llamada con el SDK de Python
- Recomendamos instalar la última versión del SDK de Python de DashScope para evitar posibles errores en tiempo de ejecución. Para obtener más información, consulte Instalar o actualizar el SDK.
- No se admiten interfaces asíncronas.
Ejemplos de solicitud
Ejemplo de respuesta
La URL de la imagen es válida durante 24 horas. Descargue la imagen rápidamente.
Los camposinput_tokens,output_tokensycharactersson compatibles. Sus valores están actualmente fijados en 0.
Llamada con el SDK de Java
Ejemplos de solicitud
Ejemplos de respuesta
La URL de la imagen es válida durante 24 horas. Descargue la imagen rápidamente.
Códigos de error
Si la llamada al modelo falla y devuelve un mensaje de error, consulte Códigos de error para su resolución.
Facturación y limitación de tasa
- Para conocer las cuotas gratuitas de los modelos y las tarifas de facturación, consulte la Lista de modelos.
- Consulte Qwen-Image para obtener detalles sobre los límites de tasa del modelo.
- Facturación: Se le factura por cada imagen generada correctamente. Las llamadas fallidas no generan cargos ni consumen su cuota gratuita para nuevos usuarios.




