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-4.0"
requerido
Nombre del modelo de generación de imágenesModelos admitidos: seedream-4.0, seedream-4-0, Seedream-4.0Ejemplo: "seedream-4.0"
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 imagenMáximo 1000 caracteres
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
  • 9:21 - Ultravertical
  • 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.
string
predeterminado:"2K"
Resolución de la imagenResoluciones admitidas:
  • 1K - Resolución básica
  • 2K - Resolución estándar (predeterminada)
  • 4K - Alta definición
Tamaños de referencia por resolución:
integer
Número de imágenes a generarRango: 1-15 (mínimo 1, máximo 15)Predeterminado: 1Nota:
  • 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 image-to-image o edición de imágenesSe 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,{base64-data}
  • Formatos de imagen admitidos: jpeg, png
  • Ejemplo: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ Nota: el prefijo data:image/jpeg;base64, es obligatorio
Límites:
  • 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
  • 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:"standard"
Modo de optimización del prompt
  • standard: modo estándar, genera contenido de mayor calidad con mayor tiempo de procesamiento
  • fast: modo rápido, genera contenido en menos tiempo con calidad regular
Predeterminado: standard
string
predeterminado:"disabled"
Modo de generación secuencial de imágenes (función específica de Doubao)Controla si se generan múltiples imágenes:
  • disabled: desactiva el modo secuencial; genera solo 1 imagen aunque haya varias referencias (predeterminado)
  • auto: activa el modo secuencial; permite generar múltiples imágenes
Notas de uso:
  • ✅ Debe proporcionar image_urls: se requiere al menos 1 imagen de referencia
  • ✅ Establezca n: 3 o use sequential_image_generation: "auto" + max_images: 3
  • ✅ Esto generará 3 imágenes distintas a partir de las imágenes de referencia
  • ⚠️ Cuando n > 1, se configurará automáticamente como auto
Limitaciones:
  • El text-to-image puro (sin image_urls) no puede generar múltiples imágenes: es una limitación de la API de Doubao
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, rango: 1-15
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