Introducción
Qwen Image 3.0 Texto a imagen convierte un brief escrito en una imagen por solicitud. Lo que lo distingue es la tipografía: las cadenas que pones entre comillas —el cartel de una puerta, el letrero de un bar, el titular de un póster— se renderizan como texto de verdad y no como una textura con forma de letras.
Qwen Image 3.0 es el modelo de imagen de Alibaba especializado en renderizar texto: prompts de 5.000 caracteres, ocho proporciones, un nivel de 1K o 2K y un endpoint de edición que lee de una a tres referencias. Sin censura y sin marcas que activar.
Elige un modo de Qwen Image 3.0 según tu material de partida
| Material de partida | Modo |
|---|---|
| Una dirección de arte o un brief de diseño por escrito | Qwen Image 3.0 Texto a imagen |
| Una imagen fuente aprobada que quieres revisar | Qwen Image 3.0 Edición de imagen |
Funciones y aspectos destacados
Composición de imagen pensada para el texto
Qwen Image 3.0 es útil para conceptos visuales en los que el texto aportado, la composición y el tratamiento de la imagen deben considerarse juntos. Trata las letras generadas como un borrador de diseño y revísalas antes de publicar.
Componer desde cero y revisar una fuente son trabajos distintos
Usa texto a imagen para levantar una imagen a partir de un brief escrito. Usa la edición de imagen cuando una imagen existente aporta la identidad, la composición o el material que hay que conservar mientras se hace un cambio concreto.
Revisa la jerarquía antes que el detalle decorativo
En pósteres, envases y conceptos de campaña, decide primero la jerarquía del mensaje y el punto focal. Un resultado atractivo sigue sin cumplir el encargo si el texto aprobado o los datos del producto no aparecen correctamente.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5 000 caracteres, en chino o inglés y sin marca de idioma. Pon entre comillas simples cada cadena que deba aparecer en la imagen y mantén cada una en torno a ocho palabras. mínimo 1 caracteres · máximo 5000 caracteres |
aspect_ratio | No | Compone el cuadro antes de generar en vez de recortarlo después, así que elige la forma en la que la imagen se va a publicar. Las ocho proporciones cuestan lo mismo por imagen. |
resolution | No | 1k o 2k, con 2k por defecto, y única variante de precio aquí. Genera en 2k todo lo que lleve texto legible; 1k es para bocetos de diseño rápidos donde nada tiene que leerse. |
num_outputs | No | Fijo en 1: cada solicitud devuelve una imagen. Para una hoja de contactos desde un solo brief, lanza solicitudes en paralelo sin seed; cada una se cotiza y se liquida por separado. |
enable_prompt_expansion | No | Activa por defecto en esta familia. Rellena briefs flojos y reescribe los detallados, así que desactívala en cuanto tu prompt sea una descripción de plano precisa. Valor predeterminado: |
negative_prompt | No | Hasta 2 000 caracteres de exclusiones, fuera del prompt principal. máximo 2000 caracteres |
prompt_optimization_mode | No | Cómo reescribe tu brief la expansión del prompt mientras |
seed | No | Omítela mientras exploras y cada llamada sacará la suya. Fíjala en cuanto un cuadro funcione y después cambia otro campo por vez para ver qué hizo cada cambio. |
Precios
| Especificación | Precio |
|---|---|
| $0.03 / imagen |
| $0.03 / imagen |
Casos de uso
Partir de un brief escrito
Usa este modo cuando la imagen todavía no tiene fuente y parte de su texto tiene que leerse: un letrero, una etiqueta, un titular. Elige la proporción en la que vas a publicar, deja la resolución en 2k y pon cada cadena entre comillas simples dentro del prompt.
Sets de personajes y series de moda
Los prompts de estilismo que otras APIs rechazan funcionan aquí sin marcador. Fija la semilla que te dio el personaje y luego cambia un detalle por solicitud —vestuario, luz, pose— para obtener un conjunto coherente en lugar de un montón de resultados sin relación.
Maquetas de pósteres y envases
Titular, subtítulo y una línea legal, todo renderizado en la imagen en 2k y en la proporción que de verdad usa el emplazamiento. Sirve para presentar un layout antes de que un diseñador ponga tipografía real sobre una imagen limpia.
Escenografías de hotelería y ambientación
Habitaciones de hotel, bares y vestíbulos donde un cartel concreto tiene que leerse bien: colgadores de puerta, números de habitación, cartas de cócteles, neón sobre la barra. Genera la imagen con el texto ya en su sitio en lugar de montar tipografía sobre un render después.
Guía de prompts y consejos prácticos
Elige primero la proporción y el nivel
aspect_ratio compone la imagen, no la recorta, así que elige la forma en la que vas a publicar. Deja la resolución en 2k siempre que la imagen lleve texto; baja a 1k solo para bocetos de layout donde nada tenga que leerse.
Describe la escena y cita el texto al pie de la letra
Describe sujeto, vestuario, luz y objetivo, y luego pon cada cadena exacta entre comillas simples, de unas ocho palabras como mucho. enable_prompt_expansion está activado por defecto y reescribe los prompts detallados, así que desactívalo cuando tu texto ya sea una descripción precisa de la toma.
Adapta el ejemplo incluido
Parte del ejemplo publicado con aspect_ratio: 3:4 y resolution: 2k. Cambia el sujeto y la dirección creativa, pero conserva el contrato de entrada de este modo.
Editorial photograph, an adult woman sitting on a hotel bed in a navy satin slip dress, city lights blurred through the window behind her, a brass door hanger hanging in sharp foreground reading 'DO NOT DISTURB', warm tungsten bedside lamp, cinematic 35mm, shallow focus, moody blue and amber palette.
Esta es la solicitud exacta detrás del fotograma publicado: una escena de hotel en 3:4 en el nivel 2k, con el texto del colgador de la puerta citado en el prompt.
Revisa el resultado antes de iterar
Las cadenas cortas entre comillas son el caso fiable: una cabecera, un letrero, una etiqueta, unas ocho palabras o menos por elemento. El texto de párrafo sigue degradándose en un sinsentido de aspecto verosímil, y la letra pequeña y densa es lo primero que se rompe en el nivel 1k: genera la tipografía en 2k. Los alfabetos no latinos se renderizan, pero revísalos: con los caracteres poco comunes, el modelo tiene más seguridad que acierto.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"num_outputs": 1,
"aspect_ratio": "1:1",
"prompt_optimization_mode": "direct"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.


















