> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Qwen Image 3.0 > - Qwen (qwen-image-3.0) es la **edición estándar** de la generación y edición de imágenes Qwen 3.0 y admite igualmente los dos modos: generación de imagen a partir de texto (T2I, sin imagen de referencia) y edición de imagen (I2I, con 1-3 imágenes de referencia), equilibrando calidad y velocidad - Los parámetros de solicitud, el criterio de tamaño y la estructura de respuesta son **idénticos** a los de [qwen-image-3.0-pro](/es/api-manual/image-series/qwen/qwen-image-3.0-pro); solo cambian la calidad de generación y el precio - Modo de procesamiento asíncrono, usa el ID de tarea devuelto para [consultar](/es/api-manual/task-management/get-task-detail) - Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente **Facturación:** - Se factura por «número de imágenes de salida × nivel de resolución»; en la edición estándar **`1K` y `2K` cuestan lo mismo** (a diferencia de Pro, donde 2K es más caro) - Si se envían imágenes de referencia (I2I), **cada imagen de referencia se factura una vez aparte**; este cargo es independiente de `n` y no crece con el número de imágenes de salida - El precio unitario es inferior al de Pro: elige este modelo cuando prime la relación calidad-precio ## OpenAPI ````yaml es/api-manual/image-series/qwen/qwen-image-3.0.json POST /v1/images/generations openapi: 3.1.0 info: title: qwen-image-3.0 Interface description: >- Use la edición estándar de Qwen Image 3.0 para generación y edición de imágenes con configuración simplificada de parámetros del modelo license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Entorno de producción security: - bearerAuth: [] tags: - name: Generación de imágenes description: APIs relacionadas con generación de imágenes IA paths: /v1/images/generations: post: tags: - Generación de imágenes summary: qwen-image-3.0 Interface description: >- - Qwen (qwen-image-3.0) es la **edición estándar** de la generación y edición de imágenes Qwen 3.0 y admite igualmente los dos modos: generación de imagen a partir de texto (T2I, sin imagen de referencia) y edición de imagen (I2I, con 1-3 imágenes de referencia), equilibrando calidad y velocidad - Los parámetros de solicitud, el criterio de tamaño y la estructura de respuesta son **idénticos** a los de [qwen-image-3.0-pro](/es/api-manual/image-series/qwen/qwen-image-3.0-pro); solo cambian la calidad de generación y el precio - Modo de procesamiento asíncrono, usa el ID de tarea devuelto para [consultar](/es/api-manual/task-management/get-task-detail) - Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente **Facturación:** - Se factura por «número de imágenes de salida × nivel de resolución»; en la edición estándar **`1K` y `2K` cuestan lo mismo** (a diferencia de Pro, donde 2K es más caro) - Si se envían imágenes de referencia (I2I), **cada imagen de referencia se factura una vez aparte**; este cargo es independiente de `n` y no crece con el número de imágenes de salida - El precio unitario es inferior al de Pro: elige este modelo cuando prime la relación calidad-precio operationId: createQwenImage30Generation requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/QwenImageEditRequest' examples: text_to_image: summary: Texto a imagen (T2I, sin imagen de referencia) value: model: qwen-image-3.0 prompt: >- An orange cat wearing an astronaut helmet, cyberpunk neon background size: '16:9' quality: 2K image_edit: summary: Edición de imagen (I2I, con 1-3 imágenes de referencia) value: model: qwen-image-3.0 prompt: Replace the background of this image image_urls: - https://example.com/image1.png 'n': 2 size: '1:1' quality: 2K responses: '200': description: Tarea de imagen creada exitosamente content: application/json: schema: $ref: '#/components/schemas/ImageGenerationResponse' '400': description: Parámetros de solicitud inválidos content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: No autenticado, token inválido o expirado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Cuota insuficiente, se requiere recarga content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Acceso denegado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: qwen-image-3.0' type: invalid_request_error '429': description: Límite de velocidad excedido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: QwenImageEditRequest: type: object required: - model - prompt properties: model: type: string description: Nombre del modelo enum: - qwen-image-3.0 default: qwen-image-3.0 example: qwen-image-3.0 prompt: type: string description: >- Prompt que describe la imagen a generar (texto a imagen), o cómo editar la imagen de entrada (edición de imagen). Limitado a 4500 tokens example: Replace the background of this image maxLength: 4500 image_urls: type: array description: >- Lista de URL de imágenes de referencia (**opcional**). Sin valor o array vacío = texto a imagen (T2I); con 1-3 imágenes = edición de imagen (I2I) **Nota:** - Número de imágenes de entrada admitidas por solicitud: `0-3`; más de 3 provoca un error - Solo se admiten URL de imágenes http/https públicas, no se admite base64 / data-url - El ancho y el alto de la imagen deben estar en el rango `[384-3072]` píxeles - Formatos de archivo admitidos: `.jpg`, `.jpeg`, `.png`, `.bmp`, `.webp`, `.tiff` - La URL de la imagen debe poder verse directamente desde el servidor, o descargarse directamente al acceder a ella (normalmente estas URL terminan con la extensión de la imagen, por ejemplo `.png`, `.jpg`) items: type: string format: uri example: - https://example.com/image1.png - https://example.com/image2.png 'n': type: integer description: >- Especifica el número de imágenes a generar, admite cualquier valor entero entre `[1,6]` **Nota:** - Cada solicitud se precobrará según el valor de `n`, los cobros reales se basan en el número de imágenes generadas - El cargo por las imágenes de referencia (`image_urls`) **se cobra una sola vez por imagen subida** y no crece con `n` minimum: 1 maximum: 6 default: 1 example: 1 negative_prompt: type: string description: >- Prompt negativo para describir contenido que no desea ver en la imagen, utilizado para restringir la salida **Nota:** - Admite chino e inglés, longitud máxima de `500` caracteres, cada carácter chino/letra cuenta como un carácter, el exceso se truncará automáticamente maxLength: 500 example: >- low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions size: type: string description: >- Tamaño de la imagen generada, admite tres opciones: **Opción 1 - Automático (predeterminado):** - `auto`: el modelo selecciona automáticamente el tamaño de salida adecuado según el prompt (en este caso `quality` no tiene efecto) **Opción 2 - Formato de relación de aspecto:** - `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`, `9:21` - Se usa junto con el parámetro `quality`; el sistema calcula automáticamente los píxeles correspondientes a la relación y la resolución, sin necesidad de especificarlos manualmente **Opción 3 - Formato de píxeles:** - ancho×alto, por ejemplo: `1024x1024`, `2048x2048`, `2720x1530`, etc. - Rango de píxeles totales: `[262144, 4194304]` (es decir, de 512×512 a 2048×2048) - Rango de la relación de aspecto: `[1/16, 16]`, un lado puede superar 2048px - Tanto el ancho como el alto deben ser mayores que `14px` **Nota:** - `size` y `n` son independientes entre sí; cuando `n>1` también se puede especificar el tamaño/la relación - Si no se envía `size`, el valor predeterminado es `auto` default: auto example: '16:9' quality: type: string description: >- Nivel de resolución, se usa junto con el formato de relación de aspecto de `size`; el valor predeterminado es `1K` (no tiene efecto con `auto` ni con el formato de píxeles). | Relación | 1K | 2K | |---|---|---| | `1:1` | 1024×1024 | 2048×2048 | | `2:3` | 832×1248 | 1664×2496 | | `3:2` | 1248×832 | 2496×1664 | | `3:4` | 864×1152 | 1770×2360 | | `4:3` | 1152×864 | 2360×1770 | | `4:5` | 896×1120 | 1792×2240 | | `5:4` | 1120×896 | 2240×1792 | | `9:16` | 800×1424 | 1530×2720 | | `16:9` | 1424×800 | 2720×1530 | | `21:9` | 1568×672 | 3122×1338 | | `9:21` | 672×1568 | 1338×3122 | enum: - 1K - 2K default: 1K example: 2K prompt_extend: type: boolean description: >- Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es `false` (no reescribe el prompt del usuario sin permiso); solo cuando se pasa explícitamente `true` se usa un modelo grande para optimizar el prompt positivo, con una mejora notable para prompts poco descriptivos o sencillos default: false example: true watermark: type: boolean description: >- Si agregar la marca de agua "Qwen-Image" en la esquina inferior derecha de la imagen. El valor predeterminado es `false` default: false example: false seed: type: integer description: >- Semilla aleatoria, rango `[0, 2147483647]`, usar el mismo valor de semilla puede mantener resultados de generación consistentes **Nota:** - Si no se proporciona, el algoritmo usará automáticamente una semilla aleatoria - El proceso de generación del modelo es probabilístico; incluso usando la misma semilla, no se garantiza que los resultados sean exactamente iguales cada vez minimum: 0 maximum: 2147483647 example: 12345 callback_url: type: string description: >- Dirección de callback HTTPS después de completar la tarea **Momento del callback:** - Se activa cuando la tarea se completa, falla o se cancela - Se envía después de completar la confirmación de facturación **Restricciones de seguridad:** - Solo se admite el protocolo HTTPS - El callback a direcciones IP internas está prohibido (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La longitud de la URL no debe exceder `2048` caracteres **Mecanismo de callback:** - Tiempo de espera: `10` segundos - Máximo `3` reintentos en caso de fallo (reintentos después de `1` segundo/`2` segundos/`4` segundos) - El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas - La dirección de callback que devuelve un código de estado 2xx se considera exitosa, otros códigos de estado activarán reintentos format: uri example: https://your-domain.com/webhooks/image-task-completed ImageGenerationResponse: type: object properties: created: type: integer description: Marca de tiempo de creación de la tarea example: 1757156493 id: type: string description: ID de tarea example: task-unified-1757156493-imcg5zqt model: type: string description: Nombre del modelo real utilizado example: qwen-image-3.0 object: type: string enum: - image.generation.task description: Tipo de tarea específico progress: type: integer description: Porcentaje de progreso de la tarea (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Estado de la tarea enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/TaskInfo' description: Información de tarea asíncrona type: type: string enum: - text - image - audio - video description: Tipo de salida de la tarea example: image usage: $ref: '#/components/schemas/Usage' description: Información de uso y facturación ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identificador del código de error message: type: string description: Descripción del error type: type: string description: Tipo de error TaskInfo: type: object properties: can_cancel: type: boolean description: Si la tarea puede ser cancelada example: true estimated_time: type: integer description: Tiempo estimado de finalización (segundos) minimum: 0 example: 30 Usage: type: object description: Información de uso y facturación properties: billing_rule: type: string description: Regla de facturación enum: - per_call - per_image - per_token - per_second example: per_image credits_reserved: type: number description: Número estimado de créditos consumidos minimum: 0 example: 2.2483 user_group: type: string description: Grupo de facturación al que pertenece el usuario example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Todas las APIs requieren autenticación Bearer Token## **Obtener API Key:** Visita la [Página de gestión de API Key](https://evolink.ai/dashboard/keys) para obtener tu API Key **Agregar al encabezado de la solicitud:** ``` Authorization: Bearer YOUR_API_KEY ``` ````