Qwen-Image es un modelo de generación de imágenes de propósito general que admite múltiples estilos artísticos y destaca en la representación compleja de texto. Maneja diseños de varias líneas, generación de texto a nivel de párrafo y representación de detalles finos.
Acceso rápido: Guía del usuario | Pruébelo en línea (Singapore | Pekín) | Blog técnico (más ejemplos) |
Ejemplos
Prompt | Imagen generada |
|---|---|
Un póster dibujado a mano de estilo reconfortante que presenta a tres cachorros jugando con una pelota sobre un exuberante césped verde, adornado con elementos decorativos como pájaros y estrellas. El título principal «¡A jugar a la pelota!» aparece prominentemente en la parte superior con una fuente de caricatura azul y en negrita. Debajo, el subtítulo «¡Ven [a lucir tus habilidades]!» aparece en fuente verde. Un globo de diálogo añade un encanto lúdico con el texto: «Jeje, ¡mira cómo asombro a mis amiguitos ahora!» En la parte inferior, el texto complementario dice: «¡Podemos volver a jugar a la pelota con nuestros amigos!» La paleta de colores se centra en verdes y azules frescos, con acentos en tonos rosa brillante y amarillo para resaltar una atmósfera alegre e infantil. | ![]() |
Resumen de modelos
Modelo | Descripción | Especificaciones de la imagen de salida |
|---|---|---|
qwen-image-2.0-pro Mismas capacidades que qwen-image-2.0-pro-2026-04-22 | Serie Pro Qwen para generación y edición de imágenes. Ofrece un renderizado de texto más potente, texturas realistas y adherencia semántica. Para la edición de imágenes, consulte Edición de Qwen-Image. | Resolución: Establezca el ancho y el alto libremente. El total de píxeles debe estar entre 512×512 y 2048×2048. La resolución predeterminada es 2048×2048. Formato: 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 Mismas capacidades que qwen-image-2.0-2026-03-03 | Serie acelerada Qwen para generación y edición de imágenes. Equilibra la calidad y la velocidad de respuesta. Para la edición de imágenes, consulte Edición de Qwen-Image. | |
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 realizar llamadas mediante el SDK, instale el SDK de DashScope.
API síncrona
HTTP
Las llamadas síncronas devuelven resultados en una única solicitud.
Singapur:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Beijing:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Reemplace {WorkspaceId} con su ID de espacio de trabajo real.
Parámetros de solicitud |
|
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)Nombre del modelo. Ejemplo: qwen-image-2.0-pro. | |
input object (obligatorio)Información de entrada.
Propiedades messages array (obligatorio)Matriz de objetos de mensaje. Solo se admiten conversaciones de un solo turno, por lo que la matriz debe contener exactamente un elemento.
Propiedades rol string (obligatorio)Rol del mensaje. Establecido en user.contenidoarray (obligatorio)Matriz de objetos de contenido de mensaje.
Propiedades texto string(obligatorio)Una indicación positiva que describe el contenido, estilo y composición de la imagen que want.Admite chino e inglés. La serie qwen-image-2.0 acepta hasta 1,300 tokens. Otros modelos aceptan hasta 800 tokens. El sistema trunca los tokens excedentes.Nota: Solo se permite un campo de texto. Omitirlo o proporcionar más de uno devuelve un error. | |
parameters object (opcional)Parámetros de procesamiento de imágenes.
Propiedades negative_prompt string (opcional)Una indicación negativa que describe lo que no want en la imagen.Admite chino e inglés. La longitud máxima es de 500 caracteres. Los caracteres excedentes se truncan automáticamente.Ejemplo: Baja resolución, baja calidad, extremidades distorsionadas, dedos malformados, colores sobresaturados, apariencia cerosa, sin detalles faciales, superficies excesivamente lisas, aspecto generado por IA. Composición caótica. Texto borroso o distorsionado.size string (opcional)Resolución de la imagen de salida, formateada como width*height.Modelos de la serie qwen-image-2.0: El total de píxeles debe estar entre 512×512 y 2048×2048. La resolución predeterminada es 2048×2048. Resoluciones recomendadas:
integer (opcional)Número de imágenes de salida. El valor predeterminado es 1.Para los modelos de la serie qwen-image-2.0, puede elegir de 1 a 6 imágenes.prompt_extend bool (opcional)Habilitar la reescritura inteligente de indicaciones. El modelo optimiza la indicación positiva. No afecta a la indicación negativa.
Ver ejemplos de reescritura Prompt original (orig_prompt): Un gato atigrado sentado con una expresión alegre, de aspecto vivaz, adorable e increíblemente realista.Prompt real (actual_prompt): Retrato fotorrealista de vida silvestre: Un gato atigrado sentado con un pelaje exuberante y besado por el sol y una expresión vibrante y alegre, con ojos que brillan de curiosidad y calidez. La cabeza del gato está ligeramente inclinada, las orejas erguidas hacia adelante y la boca suavemente abierta en una pose satisfecha y vivaz, irradiando un encanto adorable y un detalle realista increíble. La iluminación natural suave realza la textura de cada bigote y mechón de pelo individual, con sutiles reflejos en el hocico y el interior de las orejas. Fondo: un jardín otoñal suavemente desenfocado en la hora dorada, con tonos cálidos de hojas ámbar, luz solar moteada filtrándose a través de los árboles y leves indicios de escalones de piedra cubiertos de musgo. La composición enfatiza al gato como punto focal central, capturado con un enfoque nítido y poca profundidad de campo. Estilo: fotografía ultrarrealista, nivel de detalle de National Geographic, resolución 8K, Canon EOS R5, apertura f/1.2, iluminación cinematográfica, gradación de color true a la realidad, postprocesamiento mínimo. Sin texto ni superposiciones. bool (opcional)Añade una marca de agua «Qwen-Image» a la esquina inferior derecha de la imagen. Predeterminado: false. Estilo de marca de agua: integer (opcional)Semilla de número aleatorio. Rango válido: [0,2147483647].Usar la misma seed produce resultados similares. 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. |
Parámetros de respuesta |
Las URL de las imágenes son válidas solo durante 24 horas y luego se eliminan automáticamente. Guarde las imágenes generadas con prontitud. |
output objectInformación de salida de la tarea.
Propiedades choices arraySalida del modelo. Esta matriz contiene exactamente un elemento.
Propiedades finish_reason stringMotivo por el que se detuvo la tarea. El valor es stop para detenciones naturales.message objectMensaje de respuesta del modelo.
Propiedades role stringRol del mensaje. Valor fijo: assistant.contentarray
Propiedades imagen stringURL de la imagen generada (formato PNG). Caduca después de 24 horas. Descárguela y guárdela con prontitud.objectEstadísticas de resultados de tareas. No se devuelve para los modelos de la serie qwen-image-2.0.
Propiedades TOTAL integerNúmero total de tareas.SUCCEEDED integerNúmero de tareas exitosas.FAILED integerNúmero de tareas fallidas. | |
usage objectLas llamadas síncronas del SDK ImageSynthesis no devuelven este campo.
Propiedades image_count integerNúmero de imágenes generadas. Para los modelos de la serie qwen-image-2.0, esto equivale al valor n solicitado (1–6).width integerAncho de la imagen generada, en píxeles.height integerAlto 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
El SDK de DashScope es compatible con Python y Java.
Los nombres de los parámetros en el SDK coinciden estrechamente con los parámetros HTTP, y las estructuras de los parámetros siguen las convenciones específicas del lenguaje. Para los parámetros de llamadas síncronas, consulte HTTP.
- Python
- Java
Ejemplo de solicitud
Ejemplo de respuesta
Las URL de las imágenes caducan después de 24 horas. Descargue las imágenes con prontitud.
Uso con el SDK de OpenAI Agents
Los modelos de generación de imágenes como Qwen-Image se invocan a través de la API nativa de DashScope y no admiten el modo compatible con OpenAI (compatible-mode), por lo que no pueden utilizarse directamente como modelo de razonamiento de un Agente en el SDK de Agentes de OpenAI.
En frameworks de agentes como el SDK de Agentes de OpenAI, puede encapsular la generación de imágenes como una herramienta (function tool) y permitir que un modelo de chat de texto que admita el modo compatible con OpenAI (como qwen-plus) actúe como núcleo de razonamiento del Agente para orquestarla. Por ejemplo:
Antes de ejecutar, instale las dependencias: pip install openai-agents dashscope.
Facturación y limitación de tasa
- Para cuotas gratuitas y precios, consulte Precios de modelos.
- Para límites de velocidad, consulte Qwen-Image.
- Detalles de facturación: Se factura cada imagen generada correctamente. Las llamadas fallidas o los errores de procesamiento no generan cargos ni consumen su cuota gratuita para nuevos usuarios.
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.
FAQ
P: ¿Debo habilitar o deshabilitar el parámetro prompt_extend?
R: Active esta opción (predeterminada) si desea want un contenido de imagen más diverso y que el modelo añada detalles. Desactívela si necesita un control más estricto sobre los detalles de la imagen y optimice sus prompts utilizando la Guía de prompts de texto a imagen.
P: ¿Cuáles son las diferencias entre los modelos de la serie qwen-image-2.0?
R:
-
Modelos combinados de generación y edición de imágenes: Admiten tanto texto a imagen como edición de imágenes.
qwen-image-2.0-proyqwen-image-2.0-pro-2026-03-03: Mismas capacidades. La serie Pro ofrece una representación de texto más profesional, texturas realistas más finas, escenas realistas detalladas y una mayor adherencia semántica. Solo admite llamadas síncronas.qwen-image-2.0yqwen-image-2.0-2026-03-03: Mismas capacidades. La versión acelerada equilibra el rendimiento y la calidad del modelo. Solo admite llamadas síncronas.
