Wan2.6 admite entrada de múltiples imágenes, edición de imágenes y salida de texto e imagen intercalados.
Resumen de modelos
Modelo | Descripción | Especificaciones de la imagen de salida |
|---|---|---|
wan2.6-image | Edita imágenes y genera salida de texto e imagen intercalada. | Formato de imagen: PNG La resolución y las dimensiones de la imagen se configuran mediante el parámetro size. |
Requisitos previos
Obtenga una clave API y exporte la clave API como variable de entorno.
HTTP síncrono
Devuelve resultados en una sola solicitud. Recomendado para la mayoría de los escenarios.
- Singapore
- EE. UU. (Virginia)
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generationAl realizar la llamada, reemplace {WorkspaceId} con su ID de espacio de trabajo real.El ámbito de implementación global (región de Frankfurt) solo admite llamadas asíncronas.
Parámetros de solicitud |
|
Encabezados de solicitud | |
Content-Type string (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-SSEstring (Opcional)Habilita la salida en streaming.
| |
Cuerpo de la solicitud | |
model string (Obligatorio)Nombre del modelo. Establezca en wan2.6-image. | |
input object (Obligatorio)Configuración de entrada.
Propiedades messages array (Obligatorio)Matriz de contenido de la solicitud. Solo se admiten conversaciones de un solo turno: proporcione un par rol-contenido.
Propiedades role string (Obligatorio)Rol del mensaje. Establecido en user.contentarray (Obligatorio)Matriz de contenido del mensaje.
Propiedades text string(Obligatorio)Prompt positivo que describe el contenido, estilo y composición deseados de la imagen.Admite chino e inglés. Máximo 2,000 caracteres (cada carácter chino, letra, dígito o símbolo cuenta como uno). Se trunca automáticamente si se excede.Ejemplo: Genere un salteado de tomate y huevo basado en este estilo de imagen.Nota: La matriz content debe contener exactamente un objeto con un campo text.imagestring(Opcional)URL o cadena codificada en Base64 de la imagen de entrada.Restricciones de imagen:
| |
parameters object (Opcional)Parámetros de generación.
Propiedades negative_prompt string (opcional)Una indicación negativa que describe lo que no want en la imagen.Admite chino e inglés. La longitud máxima es de 500 caracteres. Los caracteres excedentes se truncan automáticamente.Ejemplo: Baja resolución, baja calidad, extremidades distorsionadas, dedos malformados, colores sobresaturados, apariencia cerosa, sin detalles faciales, superficies excesivamente lisas, aspecto generado por IA. Composición caótica. Texto borroso o distorsionado.size string (Opcional)Resolución de la imagen de salida. Admite dos métodos: hacer referencia a las proporciones de la imagen de entrada o especificar directamente las dimensiones.Cuando enable_interleave=false (modo de edición de imagen):
enable_interleave=true (modo de salida de texto e imagen intercalada):
Resoluciones recomendadas para relaciones de aspecto comunes
bool (Opcional)Controla el modo de generación de imágenes:
integer (Opcional)Número de imágenes a generar. El comportamiento depende de enable_interleave:
integer (Opcional)Solo efectivo en modo de texto e imagen intercalada (enable_interleave=true).
bool (Opcional)Solo efectivo en modo de edición de imagen (enable_interleave = false).Habilita la reescritura inteligente de prompts. Optimiza solo el prompt positivo; el prompt negativo permanece sin cambios.
bool (Opcional)Habilita la salida en streaming. Obligatorio (establecer en true) cuando enable_interleave=true.
bool (Opcional)Añade una etiqueta de marca de agua en la esquina inferior derecha de la imagen con el texto fijo "AI Generated".
integer (opcional)Semilla de número aleatorio. Rango válido: [0,2147483647].Usar la misma seed produce resultados similares. Si se omite, el algoritmo utiliza una semilla aleatoria.Nota: La generación de imágenes es probabilística. Incluso con la misma seed, los resultados pueden variar. |
Parámetros de respuesta |
Los datos de la tarea (estado de la tarea y URL de imágenes) se conservan solo durante 24 horas y luego se eliminan automáticamente. Guarde las imágenes generadas con prontitud. |
output objectSalida de la tarea.
Propiedades choices array of objectContenido de salida generado por el modelo.
Propiedades finish_reason stringMotivo de finalización de la tarea.Escenario de salida sin streaming: Se detiene naturalmente con stop.Escenario de salida en streaming: Este parámetro indica si el flujo de datos ha terminado de transmitirse.
objectMensaje devuelto por el modelo.
Propiedades role stringRol del mensaje, fijo como assistant.contentarray
Propiedades type stringTipo de salida. Valores enumerados: text, image.text stringTexto generado.imagen stringURL de la imagen generada en formato PNG.El enlace expira después de 24 horas. Descargue y guarde la imagen a la brevedad.boolIndicador de finalización de solicitud.
| |
usage objectEstadísticas de salida. Solo cuenta resultados exitosos.
Propiedades image_count integerNúmero de imágenes generadas.size stringResolución de las imágenes generadas. Ejemplo: 1376*768.input_tokens integerFacturado por recuento de imágenes.
integerFacturado por recuento de imágenes.
integerFacturado por recuento de imágenes.
| |
request_id 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. |
asíncrono HTTP
Proceso: Crear tarea → Consultar resultados
Paso 1: Crear tarea y obtener ID de tarea
- Singapore
- EE. UU. (Virginia)
- China (Beijing)
- Germany (Frankfurt)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generationAl realizar la llamada, 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 solicitud | |
Encabezados de solicitud | |
Content-Type string (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-Asyncstring(Requerido)Interruptor de modo asíncrono. Debe establecerse en enable. | |
Cuerpo de la solicitud | |
model string (Obligatorio)Nombre del modelo.Ejemplo: wan2.6-image | |
input object (Obligatorio)Configuración de entrada.
Propiedades messages array (Obligatorio)Matriz de contenido de la solicitud. Solo se admiten conversaciones de un solo turno: proporcione un par rol-contenido. No se admiten conversaciones de múltiples turnos.
Propiedades role string (Obligatorio)Rol del mensaje. Establecido en user.contentarray (Obligatorio)Matriz de contenido del mensaje.
Propiedades text string(Obligatorio)Prompt positivo que describe el contenido, estilo y composición deseados de la imagen.Admite chino e inglés. Máximo 2,000 caracteres (cada carácter chino, letra, dígito o símbolo cuenta como uno). Se trunca automáticamente si se excede.Ejemplo: Genere un salteado de tomate y huevo basado en este estilo de imagen.Nota: La matriz content debe contener exactamente un objeto con un campo text.imagestring(Opcional)URL o cadena codificada en Base64 de la imagen de entrada.Restricciones de imagen:
| |
parameters object (Opcional)Parámetros de generación.
Propiedades negative_prompt string (opcional)Una indicación negativa que describe lo que no want en la imagen.Admite chino e inglés. La longitud máxima es de 500 caracteres. Los caracteres excedentes se truncan automáticamente.Ejemplo: Baja resolución, baja calidad, extremidades distorsionadas, dedos malformados, colores sobresaturados, apariencia cerosa, sin detalles faciales, superficies excesivamente lisas, aspecto generado por IA. Composición caótica. Texto borroso o distorsionado.size string (Opcional)Resolución de la imagen de salida. Admite dos métodos: hacer referencia a las proporciones de la imagen de entrada o especificar directamente las dimensiones.Cuando enable_interleave=false (modo de edición de imagen):
enable_interleave=true (modo de salida de texto e imagen intercalada):
Resoluciones recomendadas para relaciones de aspecto comunes
bool (Opcional)Controla el modo de generación de imágenes:
integer (Opcional)Número de imágenes a generar. El comportamiento depende de enable_interleave:
integer (Opcional)Solo efectivo en modo de texto e imagen intercalada (enable_interleave=true).
bool (Opcional)Solo efectivo en modo de edición de imagen (enable_interleave = false).Habilita la reescritura inteligente de prompts. Optimiza solo el prompt positivo; el prompt negativo permanece sin cambios.
bool (Opcional)Añade una etiqueta de marca de agua en la esquina inferior derecha de la imagen con el texto fijo "AI Generated".
integer (opcional)Semilla de número aleatorio. Rango válido: [0,2147483647].Usar la misma seed produce resultados similares. Si se omite, el algoritmo utiliza una semilla aleatoria.Nota: La generación de imágenes es probabilística. Incluso con la misma seed, los resultados pueden variar. |
Parámetros de respuesta |
Guarde el task_id para consultar el estado y el resultado de la tarea. |
output objectSalida 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
| |
request_id 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. |
Paso 2: Consultar resultados mediante ID de tarea
- Singapore
- EE. UU. (Virginia)
- China (Beijing)
- Germany (Frankfurt)
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 solicitud |
Reemplace {task_id} con el valor task_id devuelto por la llamada a la API anterior. El task_id es válido para consultas durante 24 horas. Reemplace {WorkspaceId} con su ID de espacio de trabajo real. |
Encabezados de solicitud | |
Authorization string (Requerido)Autentica la solicitud con una clave API de Model Studio. Ejemplo: Bearer sk-xxxx. | |
Parámetros de ruta de URL | |
task_id string (Obligatorio)El ID de la tarea. |
Parámetros de respuesta |
Los datos de la tarea (estado de la tarea y URL de imágenes) se conservan solo durante 24 horas y luego se eliminan automáticamente. Guarde las imágenes generadas con prontitud. |
output objectInformació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.finished boolIndicador de finalización de solicitud.
array of objectContenido de salida generado por el modelo.
Propiedades finish_reason stringMotivo de finalización de la tarea. Se detiene naturalmente con stop.message objectMensaje devuelto por el modelo.
Propiedades role stringRol del mensaje, fijo como assistant.contentarray
Propiedades type stringTipo de salida. Valores enumerados: text, image.text stringTexto generado.imagen stringURL de la imagen generada en formato PNG.El enlace expira después de 24 horas. Descargue y guarde la imagen a la brevedad. | |
usage objectEstadísticas de salida. Cuenta solo los resultados exitosos.
Propiedades image_count integerNúmero de imágenes generadas.size stringResolución de las imágenes generadas. Ejemplo: 1376*768.input_tokens integerRecuento de tokens de entrada. Facturado por recuento de imágenes. Actualmente fijo en 0.output_tokens integerRecuento de tokens de salida. Facturado por recuento de imágenes. Actualmente fijo en 0.total_tokensintegerRecuento total de tokens. Facturado por recuento de imágenes. Actualmente fijo en 0. | |
request_id 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. |
DashScope Python SDK
Los parámetros del SDK se alinean con la interfaz HTTP, adaptados según las convenciones de cada lenguaje.
El SDK gestiona las llamadas asíncronas internamente y admite tanto la invocación síncrona como la asíncrona.
La duración real varía según la longitud de la cola y la carga del servicio.
base_url y la clave API son específicos de la región. Ejemplo de llamada desde la región Singapore:
- Singapore
- EE. UU. (Virginia)
- China (Beijing)
- Germany (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Al realizar la llamada, reemplace {WorkspaceId} con su ID de espacio de trabajo real.El ámbito de implementación global (región de Frankfurt) solo admite llamadas asíncronas.
Edición de imágenes
- Síncrono
- Asíncrono
Ejemplo de solicitud
Ejemplo de respuesta
La URL caduca después de 24 horas. Descargue las imágenes oportunamente.
usage, al mismo nivel que output. Léase como response.usage["image_count"]. El objeto output no contiene estadísticas: response.output.usage se devuelve como {} y no contiene image_count.Salida de texto e imagen intercalados
- Síncrono (solo streaming)
- Asíncrono
Ejemplo de solicitud
Ejemplo de respuesta
La URL caduca después de 24 horas. Descargue las imágenes oportunamente.
DashScope Java SDK
Los parámetros del SDK se alinean con la interfaz HTTP, encapsulados según las convenciones de cada lenguaje.
El SDK gestiona las llamadas asíncronas internamente y admite tanto la invocación síncrona como la asíncrona.
La duración real depende de la longitud de la cola y la carga del servicio.
base_url y la clave API no son intercambiables entre regiones. Ejemplos para la región Singapore:
- Singapore
- EE. UU. (Virginia)
- China (Beijing)
- Germany (Frankfurt)
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1Al realizar la llamada, reemplace {WorkspaceId} con su ID de espacio de trabajo real.El ámbito de implementación global (región de Frankfurt) solo admite llamadas asíncronas.
Edición de imágenes
- Síncrono
- Asíncrono
Ejemplo de solicitud
Ejemplo de respuesta
La URL caduca después de 24 horas. Descargue las imágenes oportunamente.
Salida de texto e imagen intercalados
- Llamada síncrona (solo streaming)
- Llamada asíncrona
Ejemplo de solicitud
Ejemplo de respuesta
La URL caduca después de 24 horas. Descargue las imágenes oportunamente.
Limitaciones
- Validez de datos: La tarea
task_idy la imagenurlse conservan solo durante 24 horas. Después de este período, no se pueden consultar ni descargar. - Moderación de contenido: Tanto el
promptde entrada como la imagen de salida pasan por moderación de contenido. El contenido no conforme devuelve un errorIPInfringementSuspectoDataInspectionFailed. Consulte Códigos de error.
Facturación y limitación de tasa
- Cuotas gratuitas y precios: Precios de modelos.
- Para los límites de tasa del modelo, consulte Wanxiang.
- Se le cobra por cada imagen generada exitosamente. Las llamadas fallidas no generan cargos ni consumen cuota gratuita.