Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · Por defecto: 1:1 |
enable_prompt_expansion | No | Deja que el modelo añada detalles a un prompt corto. Por defecto: true |
image_urls | Sí | Fotos para editar o combinar. Di en el prompt qué aporta cada una. |
negative_prompt | No | Lo que no quieres ver. |
num_outputs | No | Cuántos resultados crear de una vez. ≥ 1 · ≤ 1 · Por defecto: 1 |
prompt | Sí | Describe the subject, composition, lighting, and any text to render. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 1k · 2k · Por defecto: 2k |
seed | No | Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647 |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por imagen | ≈ USD |
|---|---|---|
| resolution 1K | 6 | 0,06 US$ |
| resolution 2K | 11,25 | 0,11 US$ |
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Qwen Image 3.0 Pro en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model alibaba/qwen-image-3.0-pro/edit y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0-pro/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"aspect_ratio": "1:1",
"resolution": "2k",
"num_outputs": 1
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Qwen Image 3.0 Pro
¿Cuánto cuesta la API de Qwen Image 3.0 Pro?
Qwen Image 3.0 Pro cuesta desde 6 créditos (0,06 US$) por imagen con Editar imagen, su tarea más barata. Precios por opción: 1K 6 créditos por imagen, 2K 11,25 créditos por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Qwen Image 3.0 Pro en la API?
Pon alibaba/qwen-image-3.0-pro/text-to-image para Crear imagen; alibaba/qwen-image-3.0-pro/edit para Editar imagen en el campo model de POST /jobs/createTask.
¿En qué se diferencia Qwen Image 3.0 Pro de Qwen Image 3.0?
Misma forma de solicitud, mismos campos, techo de detalle más alto, sobre todo visible en tipografía de varios elementos y en materiales finos. Explora en 3.0 y entrega en Pro; el prompt no necesita reescribirse entre uno y otro.
¿Cuántos elementos de texto puede sostener una portada?
Tres o cuatro cadenas cortas es el rango confiable: un titular, una línea de edición y una o dos de portada. Cita cada una por separado y di dónde va. Los párrafos completos de texto corrido siguen rompiéndose.
¿Qué proporción conviene para una portada?
3:4 o 2:3. Ambas se componen para esa forma desde el principio, que no es lo mismo que recortar un cuadrado: el sujeto y la tipografía se disponen para el cuadro que pediste.
¿Puedo editar una portada existente en vez de regenerarla?
Sí, en el endpoint image-to-image. Pasa el cuadro en image_urls, cita la redacción vieja y la nueva y nombra todo lo que debe quedar idéntico: pose, encuadre, etalonaje.
¿Puedo obtener varias variantes de un diseño?
No en una sola llamada: num_outputs está fijo en 1. Lanza el mismo brief como solicitudes en paralelo sin seed. Cada una devuelve una imagen y se cotiza por separado, y como solo cambia el sorteo, las lecturas siguen siendo directamente comparables.
¿Qué límites tiene la API de Qwen Image 3.0 Pro?
Resoluciones: 1K · 2K; Relaciones de aspecto: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +2; Imágenes de referencia: 3; Longitud del prompt (caracteres): 5,000; Subida máxima: 10 MB. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Qwen Image 3.0 Pro sin escribir código?
Sí. El Playground ejecuta Qwen Image 3.0 Pro con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de Qwen Image
Qwen Image 3.0 admite exactamente los mismos prompts por un poco menos y es el lugar para explorar. Pro tiene el techo más alto en tipografía y materiales finos.
- API de Qwen Image 2.1 ProHasta seis imágenes 2K detalladas con un solo promptDesde 6 créditos por imagen
- API de Qwen Image 2.1 TurboRenders rápidos en 8 pasos, hasta seis por promptDesde 3 créditos por imagen
- API de Qwen Image 2.1Modelo abierto con salida 2K y fondos transparentesDesde 4 créditos por imagen
- API de Qwen Image 2.1 LoRAImágenes y ediciones con Qwen Image 2.1 y hasta tres de tus LoRADesde 5 créditos por imagen
- API de Qwen Image 3.0 ProTipografía fina y piel, tela y vidrio realistasDesde 6 créditos por imagen
- API de Qwen Image 3.0Carteles y titulares legibles dentro de la imagenDesde 5 créditos por imagen
- API de Qwen Image 2Texto a imagen sencillo y ediciones de una sola fotoDesde 6 créditos por imagen
- API de Qwen Image 2512 LoRARenders y ediciones con Qwen Image 2512 y tus propios LoRADesde 5 créditos por imagen
- API de Qwen Image Edit 2509 LoRAEdiciones Qwen con varias fotos que cargan tus propios LoRADesde 5 créditos por imagen
- API de Qwen Image 1.0 LoRAEl Qwen-Image original, con letras limpias y tus propios LoRADesde 5 créditos por imagen

