Skip to main content
POST

Autorización

string
requerido
Todas las solicitudes requieren autenticación mediante Bearer Token.Visite la página de gestión de claves de API para obtener su clave de API y, a continuación, añádala a la cabecera de la solicitud:

Modelos disponibles

La facturación se basa en imágenes generadas correctamente × precio unitario. La entrada no se factura. La resolución y la proporción no afectan al precio. Las solicitudes fallidas no se cobran.

Cuerpo de la solicitud

string
requerido
Nombre del modelo de generación de imágenes.
  • wan2.7-image-pro — Edición profesional, hasta 4K en text-to-image
  • wan2.7-image — Edición estándar, más rápida, hasta 2K
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de imagen.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
Descripción textual para la generación de la imagen, hasta 5000 caracteres.
  • Text-to-image (sin image_urls): obligatorio
  • Edición de imágenes (con image_urls): opcional pero recomendado
Ejemplo: "A flower shop with exquisite windows, beautiful wooden door, flowers on display"
array<string>
Array de URL de imágenes de entrada para escenarios de edición y referencia con múltiples imágenes.Al proporcionar este campo, la solicitud pasa al modo de edición de imágenes.Formatos admitidos: URL HTTP/HTTPS; Base64 data:image/...;base64,...Restricciones: hasta 9 imágenes; JPEG / PNG / WEBP / BMP; 240–8000 px, proporción 1:8 ~ 8:1; ≤ 20MB por imagen
La proporción de salida coincide automáticamente con la última imagen de entrada. El modo de edición admite solo hasta 2K; 4K no está disponible.
integer
predeterminado:"1"
Número de imágenes a generar.
  • Modo estándar: 1–4 (predeterminado 1)
  • Modo secuencial (enable_sequential: true): 1–12 (predeterminado 1)
Se factura por cada imagen generada correctamente. Se precobra según n.
string
Resolución de salida o proporción. Admite tres formatos:① Palabra clave de resolución (recomendado): 1K / 2K (predeterminado) / 4K (solo para wan2.7-image-pro text-to-image)② Proporción: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (utiliza el nivel 2K por defecto)③ Dimensiones en píxeles: 1024x1024 o 1024*1024
string
Palabra clave del nivel de resolución: 1K / 2K / 4K. Se puede combinar con size (proporción).
string
Prompt negativo que describe los elementos que se deben evitar. Ejemplo: "blurry, distorted, low quality"
boolean
predeterminado:"false"
Indica si debe añadirse una marca de agua “AI Generated” en la esquina inferior derecha.
integer
Semilla aleatoria, rango 0–2147483647. La misma semilla con parámetros idénticos produce resultados visualmente consistentes.
boolean
predeterminado:"true"
Activa el modo de razonamiento mejorado para mejorar la calidad de la imagen a costa de un mayor tiempo de generación.
Solo es efectivo cuando el modo secuencial está desactivado y no se proporciona ninguna imagen de entrada.
boolean
predeterminado:"false"
Activa el modo de generación secuencial de imágenes: genera múltiples imágenes coherentes temáticamente en una sola solicitud. Ideal para storyboards y series.
  • n máximo es 12 cuando está activado
  • thinking_mode y color_palette se ignoran en modo secuencial
  • wan2.7-image-pro admite hasta 2K en modo secuencial (no se admite 4K)
array
Cuadros delimitadores para edición interactiva: especifica las regiones exactas que se van a editar o donde se va a insertar contenido.Estructura: [[[x1, y1, x2, y2], ...], ...]
  • La longitud del array externo debe coincidir con la de image_urls
  • Pase [] para las imágenes sin cuadro delimitador
  • Máximo 2 cuadros por imagen; las coordenadas son valores absolutos en píxeles, con origen (0,0) en la esquina superior izquierda
Ejemplo: [[], [[989, 515, 1138, 681]]]
array<object>
Paleta de colores personalizada. Solo en modo estándar (no en modo secuencial).
  • 3–10 entradas (se recomiendan 8); cada entrada requiere hex y ratio
  • Todos los valores de ratio deben sumar exactamente 100.00%

Respuesta

string
Estado de la respuesta. Devuelve "success" en caso de éxito.
array

Ejemplos

Texto a imagen (mínimo)

Texto a imagen (con resolución)

Texto a imagen (paleta de colores personalizada)

Generación secuencial de imágenes

Edición de una sola imagen

Referencia con múltiples imágenes / fusión de elementos

Edición interactiva (cuadro delimitador)

bbox_list se corresponde uno a uno con image_urls. Pase [] para las imágenes sin selección.
Consulta de resultadosLa generación de imágenes es asíncrona. Consulte el endpoint Estado de la tarea utilizando el task_id devuelto hasta que status == completed.