Alibaba

Wan 2.7 Image

wan2.7-image-standard

Modelo de generación y edición de imágenes lanzado por Alibaba, que integra la generación de imágenes a partir de texto, la combinación de múltiples imágenes de referencia y la edición mediante instrucciones en un mismo flujo de trabajo, con soporte para la renderización de textos largos y el control de colores de marca

wan2.7-image-standard wan2.7-image/text-to-image

Probar wan2.7-image-standard

Entrada

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

wan2.7-image-standard per image

Especificaciones	Precio unitario
1K	$0.0345
2K	$0.0345

Descripción general

Wan 2.7 Image Standard es un modelo de generación y edición de imágenes desarrollado por Alibaba, que ofrece capacidades de texto a imagen e imagen a imagen a través de la interfaz unificada de HiAPI.ai. Admite hasta 9 imágenes de referencia de entrada, dos niveles de resolución (1K/2K), múltiples relaciones de aspecto y control de semilla aleatoria, lo que lo hace adecuado para desarrolladores que necesitan producciones visuales en serie o modificar imágenes mediante instrucciones, en escenarios como materiales de marca, catálogos de productos de comercio electrónico y diseño conceptual.

Aspectos destacados

Generación de texto a imagen y edición con referencia unificadas: el mismo modelo puede generar imágenes directamente a partir de texto o combinarlas o modificarlas mediante instrucciones basadas en hasta 9 imágenes de referencia, reduciendo los cambios de herramienta.
Entrada de múltiples imágenes de referencia con consistencia mantenida: admite hasta 9 imágenes públicas como referencia; el formato de salida sigue a la última imagen de referencia, lo que facilita la producción de series visuales coherentes.
Resolución y relación de aspecto controlables: permite salida en 1K o 2K y, en la generación de texto a imagen, admite varias relaciones de aspecto de 1:1 a 8:1 para adaptar el tamaño a cada espacio de exhibición.

Descripción de capacidades

Texto a imagen: genera imágenes solo con un mensaje de texto, permitiendo especificar el nivel de resolución y la relación de aspecto, con soporte para mensajes de hasta 5000 caracteres, adecuado para obtener imágenes utilizables directamente a partir de descripciones conceptuales.

Edición por instrucciones con imágenes de referencia: se pasan URL públicas de imágenes de referencia o de la imagen a editar y se describen los cambios en lenguaje natural; el modelo devuelve la imagen editada, con el formato de salida determinado por la última imagen de referencia.

Composición con múltiples referencias: acepta hasta 9 imágenes de referencia, de no más de 20 MB cada una, en formatos JPEG, PNG, BMP y WebP, y puede fusionar en una salida elementos visuales de varias imágenes de referencia.

Control de resolución y semilla: permite elegir el nivel de salida 1K o 2K; mediante una semilla aleatoria de 0 a 2147483647 se pueden obtener resultados relativamente estables con la misma entrada, lo que facilita la reproducción y la iteración por lotes.

Casos de uso

Profesionales de marketing creando materiales visuales para campañas: introducen descripciones de marca y varias imágenes de referencia de estilo para producir banners, ilustraciones y otros materiales con una estética coherente, destinados a landing pages de campañas y publicaciones en redes sociales.
Operaciones de comercio electrónico: creación de imágenes de producto y de escena: suben fotos de producto y describen los cambios de escena requeridos para obtener imágenes de producto conformes a las normas de exhibición, destinadas a páginas de detalle de producto y materiales publicitarios.
Diseñadores: generación de bocetos conceptuales y storyboards: generan bocetos de storyboard y conceptos de personajes a partir de descripciones de texto o imágenes de referencia, para discusiones de propuestas iniciales y elaboración de guiones gráficos.
Desarrolladores: integración de la API de generación de imágenes por lotes: mediante la interfaz unificada de HiAPI.ai, integran las capacidades de texto a imagen o imagen a imagen en sus propios flujos de trabajo para generar recursos de imagen en 1K/2K según sea necesario.

Limitaciones y recomendaciones de selección

La resolución de salida de la versión Standard se limita a 1K y 2K, sin niveles superiores; cuando se requiere mayor resolución o una estabilidad de composición más sólida, se puede considerar la versión Pro de la misma serie. Las imágenes de referencia solo admiten URL accesibles públicamente y no superan los 20 MB cada una; tras subir imágenes de referencia, el formato de salida queda determinado por la última imagen de referencia y ya no puede especificarse mediante parámetros. La semilla fija solo hace que los resultados sean relativamente estables, sin garantizar una reproducción exacta. En escenarios que impliquen maquetación de textos largos o control preciso de colores de marca, se recomienda validar primero el efecto con un lote pequeño de muestras antes de ampliar su uso.

Novedades

Ver el registro de cambios →

Nuevo modelo Ya está disponible el modelo de generación de imágenes wan2.7-image-standard Nov 3, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Qué relaciones de aspecto especiales admite Wan 2.7 Image?

Además de las versiones horizontales y verticales habituales, también admite relaciones de aspecto ultraanchas o ultraaltas como 21:9, 8:1 y 1:8.
¿Qué hace el Thinking Mode?

Al activarlo aumenta el tiempo de generación para mejorar el razonamiento y la organización visual de prompts complejos; para borradores rápidos puede permanecer desactivado.
¿Cómo elegir entre 1K, 2K y 4K?

Primero usa 1K o 2K para validar la dirección y, cuando finalmente necesites una salida mayor, elige 4K. El precio actual de la página es un precio fijo por imagen individual.
¿Admite imágenes de referencia?

El ID de modelo actual corresponde a una ruta de generación de imágenes puramente a partir de texto y no acepta imágenes de referencia.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: wan2.7-image-standard

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para wan2.7-image-standard y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcionalmin 0max 2147483647

Semilla aleatoria, valor de 0 a 2147483647; fijar la semilla permite obtener resultados relativamente estables; si no se pasa, es aleatoria.

promptstringObligatoriominLength 1maxLength 5000

Describe la imagen que se va a generar, o indica qué modificaciones realizar sobre la imagen de referencia; se acepta chino o inglés, longitud máxima de 5000 caracteres.

image_urlsarrayOpcionalminItems 1maxItems 9

Array de URL públicas de imágenes de referencia o imágenes a editar, máximo 9; si no se pasa, es generación texto a imagen; admite JPEG, PNG, BMP, WebP, cada imagen no supera 20 MB, lado de 240 a 8000 píxeles, relación de aspecto de 1:8 a 8:1. Al pasar imágenes, el lienzo de salida sigue a la última imagen de referencia.

Array [ string ]

resolutionstringOpcionalPredeterminado: "2K"

Nivel de resolución de salida, opciones 1K o 2K; 1K equivale aproximadamente a 1024² y 2K a 2048² en píxeles totales; por defecto 2K.

Opciones:1K2K

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto de salida, solo tiene efecto cuando no se sube imagen de referencia; al subir una imagen de referencia, el lienzo lo determina la imagen de referencia y no es necesario configurarlo. Por defecto 1:1.

Opciones:1:116:94:321:93:49:168:11:8

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan2.7-image-standard",
  "input": {
    "prompt": "…",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "wan2.7-image-standard",
    input: {
      "prompt": "…",
      "resolution": "2K",
      "aspect_ratio": "1:1"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "wan2.7-image-standard",
        "input": {
          "prompt": "…",
          "resolution": "2K",
          "aspect_ratio": "1:1"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}