Skip to main content
POST

Modelos admitidos

Prefiera -pro para texto/diseño denso. Use qwen-image-3.0 para imágenes generales. Prompt máx. ~4.5k tokens. Los nombres de modelo no son intercambiables con la serie 2.0.

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 - Standard
  • qwen-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):// o data: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
Puede omitir el nivel y pasar píxeles en 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:4
  • 16:9 / 9:16
  • 3:2 / 2:3
También acepta el estilo 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 imagen
  • agent - solo texto a imagen, reescritura más agresiva
Los valores no válidos se ignoran.

Tabla de referencia de tamaños

Combine resolution (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

  1. 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).
  2. Almacenamiento: las imágenes se reflejan en el CDN de la plataforma para acceso a largo plazo.
  3. 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.0 cobra lo mismo por 1K/2K; -pro 2K es 2× 1K. Los fallos se reembolsan por completo; las imágenes de referencia son gratuitas.
  4. Errores: tamaño/proporción no válidos, agent en 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.