El modelo Wanxiang Edición general de imágenes wan2.5 edita y fusiona imágenes únicamente a partir de instrucciones de texto, manteniendo la coherencia del sujeto en todas las ediciones.
Resumen de modelos
Capacidades del modelo | Ejemplo de entrada | Imagen de salida |
|---|---|---|
Edición de imagen única | ![]() | ![]() Reemplace el vestido floral por un vestido de encaje de estilo vintage con bordados delicados en el cuello y los puños. |
Fusión de múltiples imágenes | ![]() | ![]() Coloque el despertador de la imagen 1 junto al florero sobre la mesa del comedor en la imagen 2. |
Nombre del modelo | Descripción del modelo | Especificaciones de la imagen de salida |
|---|---|---|
wan2.5-i2i-preview | Vista previa de Wanxiang 2.5 Admite edición de imagen única y fusión de múltiples imágenes | Formato de imagen: PNG. Resolución de imagen:
|
Requisitos previos
Antes de realizar una llamada, obtenga una clave de API y expórtela como variable de entorno. Para realizar llamadas mediante el SDK, instale el SDK de DashScope.
Llamada a la API HTTP
La edición de imágenes tarda 1–2 minutos, por lo que la API utiliza invocación asíncrona: Crear tarea → Sondear resultado.
El tiempo de ejecución real varía según la longitud de la cola y la carga del servicio.
Paso 1: Crear una tarea y obtener el ID de tarea
Región de Singapur: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Región de Pekín: POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Reemplace {WorkspaceId} con su ID de espacio de trabajo real.
- Después de crear la tarea, utilice el
task_iddevuelto para consultar el resultado. Eltask_ides válido durante 24 horas. No cree tareas duplicadas. En su lugar, utilice el sondeo para recuperar el resultado. - Para obtener orientación para principiantes, consulte Llamar a APIs con Postman o cURL.
Parámetros de solicitudEncabezados de solicitudContent-Typestring (Requerido)El tipo de contenido de la solicitud. Debe ser application/json.Authorization string (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx.X-DashScope-Async string (Requerido)Habilita el procesamiento asíncrono. Las solicitudes HTTP solo admiten llamadas asíncronas. Debe ser enable.Cuerpo de la solicitudmodelstring (obligatorio)Nombre del modelo. Modelos admitidos y precios.Valor de ejemplo: wan2.5-i2i-preview.input object (requerido)Campos de entrada como el prompt y las imágenes.
Propiedades prompt string (obligatorio)Un prompt positivo que describe los elementos y las características visuales que se incluirán en la imagen generada.Admite chino e inglés. Máximo: 2000 caracteres (cada carácter cuenta como uno); el exceso se trunca.Para obtener consejos sobre la redacción de prompts, consulte la Guía de prompts de texto a imagen.Valor de ejemplo: Un gato naranja alegre sentado, realista y detallado.images array of string (requerido)Una matriz de URLs de imágenes.
string (opcional)Un prompt negativo que describe elementos a excluir de la imagen.Admite chino e inglés. Máximo: 500 caracteres; el exceso se trunca.Valor de ejemplo: baja resolución, errores, peor calidad, baja calidad, incompleto, dedos adicionales, proporciones deficientes.object (opcional)Controla la resolución, la reescritura de prompts y la marca de agua.
Propiedades size string (opcional)Establezca la resolución de la imagen de salida en formato width×height. Predeterminado: 1280×1280.
Resoluciones y relaciones de aspecto recomendadas
size, el valor predeterminado es 1280×1280 píxeles con una relación de aspecto aproximada:
integer (opcional)Número de imágenes a generar. Rango: 1–4. Valor predeterminado: 4. Establezca este valor en 1 durante las pruebas para controlar los costos.watermark boolean (opcional)Añade una marca de agua "AI Generated" en la esquina inferior derecha.
boolean (opcional)Habilita la reescritura de prompts basada en LLM para mejorar la calidad de la imagen. Añade latencia.
integer (opcional)Semilla de número aleatorio. Rango válido: [0, 2147483647].Si se omite, se genera una semilla aleatoria. Si se especifica, se asignan semillas secuenciales a cada una de las n imágenes basándose en n. Por ejemplo, si n=4, las semillas son: seed, seed+1, seed+2, seed+3.Para mejorar la reproducibilidad, fije el valor de la semilla.Las semillas idénticas no garantizan resultados idénticos debido a la generación probabilística. |
Parámetros de respuestaoutputobjectInformación de salida de la tarea.
Propiedades task_id stringEl ID de la tarea. Válido para consultas durante 24 horas.task_status stringEl estado de la tarea.
Valores de enumeración
stringIdentificador único de solicitud para rastreo y solución de problemas.code stringCódigo de error. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error.message stringMensaje de error detallado. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error. |
Guarde el task_id para consultar el estado y el resultado de la tarea. |
Paso 2: Consulte los resultados mediante el ID de tarea
- Singapore
- China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Al realizar la llamada, reemplace {WorkspaceId} con su ID de espacio de trabajo real.- Recomendación de sondeo: La generación de imágenes requiere mucho tiempo. Utilice un mecanismo de sondeo con un intervalo razonable, como 10 segundos.
- Transición de estado de la tarea: PENDING → RUNNING → SUCCEEDED o FAILED.
- Enlace de resultado: Una vez que una tarea se completa correctamente, se devuelve una URL de imagen válida durante 24 horas. Descargue y guarde la imagen en un almacenamiento permanente, como OSS.
Parámetros de solicitudEncabezados de solicitudAuthorizationstring (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx.Parámetro de ruta de URLtask_idstring (Obligatorio)El ID de la tarea. |
Reemplace 86ecf553-d340-4e21-xxxxxxxxx con su task_id real.Las claves de API son diferentes para cada región. Para más información, consulte Obtener una clave de API. Si utiliza un modelo en la región de China (Pekín), reemplace |
Parámetros de respuestaoutputobjectInformación de salida de la tarea.
Propiedades task_id stringEl ID de la tarea. Válido para consultas durante 24 horas.task_status stringEl estado de la tarea.
Valores de enumeración
stringLa hora en que se envió la tarea. La hora está en UTC+8 y el formato es YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringLa hora en que se ejecutó la tarea. La hora está en UTC+8 y el formato es YYYY-MM-DD HH:mm:ss.SSS.end_time stringLa hora en que se completó la tarea. La hora está en UTC+8 y el formato es YYYY-MM-DD HH:mm:ss.SSS.results array of objectLista de resultados de la tarea, que incluye URL de imágenes, prompts y detalles de errores para fallos parciales.
Propiedades orig_prompt stringEl prompt de entrada original, correspondiente al parámetro de solicitud prompt.actual_prompt stringEl prompt optimizado utilizado cuando la reescritura de prompts está habilitada. No se devuelve cuando está deshabilitada.url stringURL de la imagen generada.code stringCódigo de error para imágenes fallidas. Se devuelve solo para fallos parciales.message stringMensaje de error para imágenes fallidas. Se devuelve solo para fallos parciales.objectEstadísticas del resultado de la tarea.
Propiedades TOTAL integerEl número total de tareas.SUCCEEDED integerEl número de tareas exitosas.FAILED integerEl número de tareas fallidas.stringCódigo de error. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error.message stringMensaje de error detallado. Se devuelve solo para solicitudes fallidas. Consulte Códigos de error.objectEstadísticas de uso. Cuenta solo los resultados exitosos.
Propiedades image_count integerNúmero de imágenes generadas exitosamente. Facturación: Costo = Número de imágenes × Precio unitario.stringIdentificador único de solicitud para rastreo y solución de problemas. |
Las URL de las imágenes son válidas solo durante 24 horas y luego se eliminan automáticamente. Guarde las imágenes generadas con prontitud. |
Llamada al SDK de DashScope
Los parámetros del SDK coinciden con la llamada a la API HTTP, adaptados para cada lenguaje.
La edición de imágenes tarda 30–60 segundos. El SDK encapsula el flujo HTTP asíncrono y admite llamadas síncronas y asíncronas.
El tiempo de ejecución real varía según la longitud de la cola y la carga del servicio.
Llamada con el SDK de Python
- Llamada síncrona
- Llamada asíncrona
Ejemplo de solicitud
Este ejemplo admite tres métodos de entrada de imagen: URL pública, codificación Base64 y ruta de archivo local.Ejemplo de respuesta
Las URL de las imágenes caducan después de 24 horas. Descargue las imágenes oportunamente.
Llamada al SDK de Java
- Llamada síncrona
- Llamada asíncrona
Ejemplo de solicitud
Este ejemplo admite tres métodos de entrada de imagen: URL pública, codificación Base64 y ruta de archivo local.Ejemplo de respuesta
Las URL de las imágenes caducan después de 24 horas. Descargue las imágenes oportunamente.
Límites
- Retención de datos: Tanto los ID de tarea como las URL de imágenes caducan después de 24 horas. No puede consultarlos ni descargarlos después de la caducidad.
- Moderación de contenido: Todos los prompts, las imágenes de entrada y las imágenes de salida pasan por moderación de contenido. Las solicitudes que contienen contenido prohibido devuelven errores como “IPInfringementSuspect” o “DataInspectionFailed”. Consulte Información de errores para obtener más detalles.
Códigos de error
Si la llamada al modelo falla y devuelve un mensaje de error, consulte Códigos de error para su resolución.
FAQ
P: He utilizado Edición general de imágenes 2.1 anteriormente. ¿Necesito cambiar mis llamadas al SDK para usar wan2.5?
R: Sí — el diseño de parámetros difiere entre versiones:- Edición general de imágenes 2.1: Requiere tanto los parámetros
promptcomofunction. - Edición general de imágenes 2.5: Solo requiere
prompt. Describa todas las ediciones en texto. El parámetrofunctionya no es compatible ni necesario.



