Skip to main content
POST

Autorización

string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su clave de API:Visite la página de gestión de claves de API para obtener su clave de APIAñádala a la cabecera de la solicitud:

Cuerpo de la solicitud

string
predeterminado:"seedream-5-0-lite"
requerido
Nombre del modelo de generación de imágenesModelos admitidos: seedream-5-0-lite, seedream-5.0-lite, Seedream-5.0-liteEjemplo: "seedream-5-0-lite"
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
requerido
Descripción textual para la generación de la imagen
string
predeterminado:"1:1"
Proporción de la imagenProporciones admitidas:
  • 1:1 - Cuadrado (predeterminado)
  • 4:3 - Horizontal 4:3
  • 3:4 - Vertical 3:4
  • 16:9 - Panorámico horizontal
  • 9:16 - Vertical alargado
  • 3:2 - Horizontal 3:2
  • 2:3 - Vertical 2:3
  • 2:1 - Formato horizontal alargado
  • 1:2 - Formato vertical alargado
  • 21:9 - Ultrapanorámico
  • auto - Ajusta automáticamente la proporción según la imagen de referencia (requiere image_urls)
2x1 equivale a 2:1 y 1x2 equivale a 1:2. La x debe escribirse en minúscula y no se admiten espacios.
Nota: Seedream-5.0-Lite no admite la proporción 9:21
string
predeterminado:"2K"
Resolución de la imagenResoluciones admitidas:
  • 2K - Resolución estándar (predeterminada)
  • 3K - Alta definición
  • 4K - Ultra alta definición
Nota: Seedream-5.0-Lite admite resoluciones 2K, 3K y 4K, y no admite 1K
Tamaños de referencia por resolución:
integer
Número de imágenes a generarRango: 1-15Predeterminado: 1Nota:
  • Cuando n > 1, se activa automáticamente el modo de generación secuencial de imágenes
  • Debe indicar un número simple (por ejemplo, 1); no use comillas o se producirá un error
El cobro se descontará por adelantado según la cantidad
La cantidad de imágenes de referencia en image_urls + la cantidad final de imágenes generadas especificada por n debe ser ≤ 15.
array
Lista de URL de imágenes de referencia para la generación image-to-imageSe admiten dos formatos:1. URL completa de la imagen
  • URL de imagen de acceso público (http:// o https://)
  • Ejemplo: https://example.com/image.jpg
2. Formato codificado en Base64
  • Es obligatorio usar el formato Data URI completo
  • Formato: data:image/{format};base64,{base64data}
  • Formatos de imagen admitidos: jpeg, png
  • Ejemplo: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Nota: el prefijo data:image/jpeg;base64, es obligatorio
Limitaciones:
  • Formatos de imagen: jpeg, png
  • Rango de proporción (ancho/alto): [1/3, 3]
  • Ancho y alto (px) > 14
  • Tamaño: no superar los 10MB por imagen
  • Píxeles totales: no superar 6000×6000 px
La cantidad de imágenes de referencia en image_urls + la cantidad final de imágenes generadas especificada por n debe ser ≤ 15.
string
predeterminado:"jpeg"
Formato de salida de la imagen
  • jpeg: formato JPEG (predeterminado)
  • png: formato PNG, adecuado para fondos transparentes y casos similares
Nota: El parámetro output_format es exclusivo de Seedream-5.0-Lite. Otros modelos de imagen ignorarán este parámetro.
string
predeterminado:"disabled"
Modo de generación secuencial de imágenesControla si se generan múltiples imágenes:
  • disabled: desactiva el modo secuencial (predeterminado)
  • auto: activa el modo secuencial; permite generar múltiples imágenes
Notas de uso:
  • Cuando n > 1, se configurará automáticamente como auto
object
Opciones de generación secuencial de imágenesDisponible cuando sequential_image_generation se establece como autoPropiedades:
  • max_images (integer): especifica el número de imágenes a generar
Ejemplo:
boolean
predeterminado:"false"
Indica si debe añadirse una marca de agua a la imagen generada
  • true: añadir marca de agua
  • false: sin marca de agua (predeterminado)

Respuesta

integer
Código de estado de la respuesta
array
Array de datos de la respuesta