Qwen Image 3.0
Generación de imágenes Qwen Image 3.0
- Modo de procesamiento asíncrono, devuelve un ID de tarea para consultas posteriores
- Admite texto a imagen e imagen a imagen (1-3 imágenes de referencia para edición)
- Admite resolución 1K / 2K, hasta 6 imágenes por solicitud
- Variantes Standard y Pro (Pro es más potente para diseños densos y texto)
POST
Modelos admitidos
Autorizaciones
string
requerido
Todos los endpoints requieren autenticación mediante Bearer TokenObtenga su clave de API en la página de gestión de claves de API:
Body
string
requerido
Nombre del modelo
qwen-image-3.0- Standardqwen-image-3.0-pro- Pro (texto / diseño denso)
string
requerido
Descripción textual para la generación de imágenes, máx. ~4.5k tokens
string[]
Array de URL de imágenes de referencia (imagen a imagen / edición), 1-3 imágenes
- URL pública
http(s)://odata:image/png;base64,...(el base64 se vuelve a subir primero) - Formatos: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
- Por archivo ≤ 10MB; ancho/alto recomendados 384-2048 px
string
predeterminado:"1K"
Nivel de resolución (afecta el nivel de facturación)
1K(predeterminado; se aceptan minúsculas)2K
size (p. ej. 1600x900). Con píxeles en bruto, un área > 2,25M píxeles se factura como 2K.string
predeterminado:"1:1"
Proporción de aspecto, o tamaño en píxeles explícitoProporciones admitidas:
1:1(predeterminado)4:3/3:416:9/9:163:2/2:3
16x9, o píxeles como 1024x1024. Para píxeles personalizados, cada lado (ancho y alto) debe ser 512–2048, relación de aspecto 1:8 ~ 8:1.Si no se define ni size ni resolution, la salida se fija en 1024×1024.integer
predeterminado:"1"
Número de imágenes, 1-6. Los valores superiores a 6 se limitan a 6.
string
Prompt negativo: contenido a evitar
boolean
predeterminado:"false"
Reescritura inteligente del promptDesactivado por defecto para resultados predecibles. Establezca
true para activar la reescritura inteligente.string
Modo de reescritura (solo serie 3.0; requiere
prompt_extend: true)direct- funciona para texto a imagen e imagen a imagenagent- solo texto a imagen, reescritura más agresiva
Tabla de referencia de tamaños
Combineresolution (nivel) + size (proporción):
Casos de uso
Texto a imagen (múltiples)
Diseño denso con reescritura
Imagen a imagen (edición)
Prompt negativo
Límites
Response
integer
Código de estado; 200 en caso de éxito
array
Array de datos de la respuesta
Diferencias respecto a 2.0
Notas
- Asíncrono: el envío devuelve un
task_id. Consulte Obtener el estado de la tarea cada 3~5 segundos; timeout del cliente ~3 minutos (2K + multi-imagen es más lento). - Almacenamiento: las imágenes se reflejan en el CDN de la plataforma para acceso a largo plazo.
- Facturación: por imagen entregada × nivel de resolución según el área real en píxeles (> 2,25M píxeles = 2K).
qwen-image-3.0cobra lo mismo por 1K/2K;-pro2K es 2× 1K. Los fallos se reembolsan por completo; las imágenes de referencia son gratuitas. - Errores: tamaño/proporción no válidos,
agenten imagen a imagen, referencias inaccesibles/demasiado grandes → 400; límite de tasa → 429.
Consultar resultadosUse Obtener el estado de la tarea para el progreso y
result.images.