Qwen Image 3.0 API
Qwen Image 3.0 de Alibaba: endpoints Standard y Pro de texto a imagen y edición de imagen, con relaciones de aspecto flexibles, salida 1K/2K y comprensión de instrucciones en lenguaje natural.
Qwen Image 3.0 ofrece endpoints Standard y Pro de texto a imagen y edición. Elige el nivel Standard para una generación y edición 1K/2K consistentes, o Pro para una salida de mayor fidelidad con precios según la resolución.
/filters:quality(82)/examples/97938534229240bdb8457c6ae2c22e1b/1-1041bd7755e3.webp)
Resumen
Acerca de Qwen Image 3.0 API
Qué hace Qwen Image 3.0, cómo encaja en la gama de modelos de Alibaba y por qué los equipos lo eligen.
Qwen Image 3.0 es un modelo de generación y edición de imágenes de Alibaba, disponible a través de la API REST de WaveSpeedAI. Qwen Image 3.0 de Alibaba: endpoints Standard y Pro de texto a imagen y edición de imagen, con relaciones de aspecto flexibles, salida 1K/2K y comprensión de instrucciones en lenguaje natural.
Qwen Image 3.0 ofrece endpoints Standard y Pro de texto a imagen y edición. Elige el nivel Standard para una generación y edición 1K/2K consistentes, o Pro para una salida de mayor fidelidad con precios según la resolución.
La familia Qwen Image 3.0 en WaveSpeedAI incluye 4 endpoints REST que cubren los flujos de trabajo de Text-To-Image, Image-To-Image. Cada variante tiene su propio precio, parámetros y ejemplos de resultados: elige la que se ajuste a tu modalidad de entrada y a tus requisitos de producción, o llama a varias con la misma clave de API para componer flujos de varios pasos.
Ejecuta Qwen Image 3.0 con la misma clave de API, la misma cuenta de facturación y los mismos límites de uso que ya usas para los demás más de 1.000 modelos de IA de WaveSpeedAI. Sin configuración aparte por proveedor, sin SDK por proveedor, sin límites de uso distintos por proveedor: una sola integración lo cubre todo, desde texto a imagen y texto a vídeo hasta síntesis de audio, generación 3D, escalado y edición.
Endpoints
Todos los endpoints de la API de Qwen Image 3.0
4 endpoints de Qwen Image 3.0 disponibles ahora en WaveSpeedAI: elige la variante que se ajuste a tu flujo de trabajo.
/filters:quality(82)/media/images/1785949826547283917_F8QZ8hqB.webp)
Qwen Image 3.0 Text To Image
Qwen Image 3.0 Text to Image is a high-quality image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785949851816447753_YuENW5PZ.webp)
Qwen Image 3.0 Edit
Qwen Image 3.0 Edit is a high-quality image editing model that transforms existing images with natural-language instructions, delivering advanced instruction understanding, superior visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785950638933780388_UpyHQ09J.webp)
Qwen Image 3.0 Pro Text To Image
Qwen Image 3.0 Pro Text-to-Image is a professional-grade image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1785950659359092904_wW4uENW5.webp)
Qwen Image 3.0 Pro Edit
Qwen Image 3.0 Pro Edit is a professional-grade image editing model that transforms existing images with natural-language instructions, delivering advanced instruction understanding, superior visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Ejemplos
Mira Qwen Image 3.0 en acción
Resultados reales generados con la API de Qwen Image 3.0. Pasa el cursor sobre cualquier vídeo para previsualizarlo y haz clic para abrir el visor a tamaño completo.
Cómo empezar
Cómo usar la API de Qwen Image 3.0
Cuatro pasos desde el registro hasta una generación terminada. Encontrarás ejemplos completos en Python, Node.js y cURL en la sección de API más abajo.
- 01
Obtén una clave de API
Regístrate en WaveSpeedAI y copia tu clave de API desde el panel. Las cuentas nuevas incluyen créditos gratuitos para empezar: suficientes para usar el playground unas decenas de veces antes de que empiece la facturación.
- 02
Envía una predicción
Haz POST de tu entrada como JSON a https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image. El endpoint devuelve un id de predicción de inmediato: las generaciones son asíncronas, así que no mantienes una conexión abierta durante la inferencia.
- 03
Consulta hasta que termine
Haz GET a https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Devuelve los resultados con completed; detente con un error en failed, cancelled, timeout o deleted; sigue consultando con cualquier otro estado.
- 04
Lee la URL del resultado
Cuando status sea "completed", lee la URL de data.outputs[0]. La URL apunta a tu contenido generado en la CDN de WaveSpeedAI: imagen, vídeo, audio o archivo 3D según la variante de Qwen Image 3.0 que hayas llamado.
Casos de uso
Qué puedes crear con Qwen Image 3.0
Flujos de trabajo habituales para los que desarrolladores y creadores usan la API de Qwen Image 3.0.
Generación estándar de texto a imagen
alibaba/qwen-image-3.0/text-to-image crea imágenes a partir de prompts en lenguaje natural, con relaciones de aspecto flexibles y niveles de resolución de 1K o 2K.
Generación Pro para trabajo de producción
alibaba/qwen-image-3.0-pro/text-to-image ofrece el nivel de generación Pro para crear imágenes detalladas, con fidelidad al prompt y una salida de producción de mayor fidelidad.
Edición de imágenes en lenguaje natural
Los endpoints de edición Standard y Pro transforman de 1 a 3 imágenes de referencia con instrucciones en lenguaje natural, conservando el contexto visual solicitado.
Flujos creativos según la resolución
Selecciona una salida de 1K o 2K y elige una relación de aspecto antes de generar o editar, para adaptarte a flujos de entrega de marketing, producto, retrato y creatividad.
Consejos
Consejos para escribir prompts en Qwen Image 3.0
Consejos prácticos para obtener mejores resultados con Qwen Image 3.0, basados en los patrones que funcionan en modelos de imagen en flujos de producción.
- 01
Describe la iluminación, la composición y el estilo, no solo el sujeto
Pasa de «un gato» a «un gato atigrado en el alféizar de una ventana, luz suave de tarde entrando, poca profundidad de campo, composición cinematográfica de 35 mm». Sujeto + escena + iluminación + lenguaje de cámara es la fórmula de prompt que mejor aprovecha los datos de entrenamiento de los modelos de imagen.
- 02
Usa anclas de estilo en lugar de nombres de artistas
«Al estilo de la fotografía editorial» o «foto de producto de estudio, fondo blanco continuo» funciona mejor que el vago «alta calidad, obra maestra» Y evita los problemas legales y de licencias que conlleva nombrar a artistas vivos en trabajo comercial.
- 03
Especifica la resolución y la relación de aspecto de forma explícita
No dependas de los valores por defecto. Define desde el principio la relación de aspecto objetivo (1:1, 4:3, 16:9) y la resolución. Recortar o escalar después pierde la fidelidad que el modelo podría haber colocado bien en la primera generación.
- 04
Itera con una semilla fija antes de volver a lanzar
Fija la semilla y cambia un elemento del prompt cada vez. Es mucho más rápido que volver a lanzar con semillas aleatorias en cada cambio: aíslas la causa y el efecto de cada edición del prompt y llegas a la imagen objetivo con menos generaciones en total.
- 05
Usa el endpoint de edición para los refinamientos, no la regeneración completa
Genera la imagen base una vez y después usa el endpoint de edición o inpainting del modelo para refinar elementos concretos: texto, iluminación, sujetos individuales. Las ediciones conservan todo lo que te gustaba de la base y cuestan menos por iteración que las regeneraciones completas.
Precios
Precios de la API de Qwen Image 3.0
El precio es por resultado. El cargo final depende de los parámetros que definas en el playground de cada variante (resolución, duración, número de resultados, referencias).
| Endpoint | Tipo | Precio inicial |
|---|---|---|
| alibaba/ | text-to-image | $0.03 |
| alibaba/ | image-to-image | $0.03 |
| alibaba/ | text-to-image | $0.04 |
| alibaba/ | image-to-image | $0.04 |
API
Llama a la API de Qwen Image 3.0
Obtén una clave de API en wavespeed.ai/accesskey y envía una predicción por REST. El playground genera ejemplos listos para pegar con cualquier combinación de entradas.
POSThttps://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Comparar
Qwen Image 3.0 frente a las alternativas
Cuándo elegir Qwen Image 3.0 en lugar de modelos similares en WaveSpeedAI.
Qwen Image 3.0 frente a Seedream 5 Pro
Seedream 5 Pro destaca por la comprensión del diseño, la edición con varias referencias y los controles del formato de salida. Qwen Image 3.0 ofrece una superficie Standard/Pro enfocada, con generación y edición en lenguaje natural en niveles de 1K y 2K.
Qwen Image 3.0 frente a Qwen Image 2.0
Qwen Image 2.0 es la superficie de generación y edición de la generación anterior de la familia Qwen. Qwen Image 3.0 usa endpoints Standard y Pro específicos de Alibaba, con un comportamiento de generación y edición actualizado.
Preguntas frecuentes
Qwen Image 3.0 API — Preguntas frecuentes
Precios, licencia, integración: preguntas habituales sobre cómo ejecutar Qwen Image 3.0 en WaveSpeedAI.
¿Qué es la API de Qwen Image 3.0?
Qwen Image 3.0 es un modelo de generación de imágenes de Alibaba expuesto como API REST en WaveSpeedAI. Qwen Image 3.0 de Alibaba: endpoints Standard y Pro de texto a imagen y edición de imagen, con relaciones de aspecto flexibles, salida 1K/2K y comprensión de instrucciones en lenguaje natural. Puedes llamarlo por programación o probarlo desde el playground enlazado arriba.
¿Cómo llamo a la API de Qwen Image 3.0?
Regístrate en WaveSpeedAI, copia tu clave de API desde /accesskey y haz POST a https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image con tu entrada como JSON. El endpoint devuelve un id de predicción. Consulta el endpoint de resultados aproximadamente cada 2 segundos, aumenta el intervalo en las tareas largas y detente ante cualquier estado final. Arriba tienes ejemplos en Python / Node.js / cURL orientados a producción.
¿Cuánto cuesta la API de Qwen Image 3.0?
Qwen Image 3.0 empieza en $0.03. El coste exacto depende de los parámetros que definas (resolución, duración, número de resultados, referencias). La vista previa del coste en tiempo real junto al botón Generar del playground muestra el precio exacto de tu entrada actual.
¿Qué variantes de Qwen Image 3.0 hay disponibles?
WaveSpeedAI aloja 4 endpoints de Qwen Image 3.0 en producción: alibaba/qwen-image-3.0/text-to-image, alibaba/qwen-image-3.0/edit, alibaba/qwen-image-3.0-pro/text-to-image, alibaba/qwen-image-3.0-pro/edit. Cada variante tiene su propia página de playground y sus propios precios.
¿Puedo usar comercialmente los resultados de Qwen Image 3.0?
Los derechos de uso comercial dependen de la licencia del modelo de Alibaba. La mayoría de los modelos de Alibaba permiten el uso comercial de los resultados; consulta la página del playground de cada modelo para ver el resumen de su licencia y los Términos del servicio de WaveSpeedAI para las condiciones de la plataforma.
¿Por qué usar Qwen Image 3.0 en WaveSpeedAI en lugar de ir directamente al proveedor?
Una sola clave de API y una sola cuenta de facturación para Qwen Image 3.0 Y más de 1.000 modelos de IA de otros proveedores. Sin configurar un SDK por proveedor, sin límites de uso aparte y sin reescribir el código de integración para cada proveedor. Los precios suelen ser iguales o inferiores a los de la API directa de Alibaba.
Proveedor
Acerca de Alibaba
El equipo detrás de Qwen Image 3.0 y de la gama más amplia de modelos de Alibaba en WaveSpeedAI.
Tongyi Lab, de Alibaba, produce la familia de modelos de vídeo Wan y la familia de LLM Qwen. Wan destaca por publicarse con pesos abiertos, por su amplia cobertura de variantes (texto a vídeo, imagen a vídeo, referencia a vídeo, edición de vídeo, extensión de vídeo, edición de imagen, texto a imagen) y por su solidez constante en estabilidad del movimiento y fidelidad al prompt con prompts multilingües.
Empieza a crear con Qwen Image 3.0 en WaveSpeedAI
Créditos gratuitos al registrarte. Una sola clave de API para más de 1.000 modelos de IA de Alibaba y de todos los demás proveedores.
/filters:quality(82)/examples/e699bbebd6bdb91b0997ad00a6db5927/1-a0b53b852c48.webp)
/filters:quality(82)/examples/861c63aed61c2671fa3f2cc5446a7fc9/1-9313861ab37e.webp)
/filters:quality(82)/examples/aa6aaaad4738a37e20a331f53432e66e/1-3808e66eb793.webp)
/filters:quality(82)/examples/b01c4177aa64d5a63f66b59f28e734f2/1-f943c79cfc64.webp)