Respuesta rápida
- Llama a la API asíncrona de tareas de imagen con model=doubao-seedream-5-5.
- size acepta los niveles 1K/1.5K/2K o píxeles explícitos ANxAL con un total de 921.600-4.624.220 píxeles.
- metadata.background=transparent devuelve PNG RGBA. En el modo de capas, max_images limita el total de salidas incluida la base: 2-100, por defecto 30.
Parámetros clave
- model | string | obligatorio | doubao-seedream-5-5 | - | Usa doubao-seedream-5-5 como identificador exacto del modelo.
- prompt | string | opcional | - | - | Obligatorio para generar y editar; opcional cuando layer_decomposition=true.
- size | string | opcional | - | 1K | 1.5K | 2K | WIDTHxHEIGHT | En generación usa el valor por defecto del modelo y auto en capas. Los niveles no fijan la relación de aspecto; las dimensiones explícitas deben sumar 921.600-4.624.220 píxeles.
- image_urls | string[] | opcional | - | 0-10 | Proporciona de 1 a 10 imágenes de referencia JPEG, PNG o WEBP mediante image_urls. Sube primero los archivos locales y usa después las URLs devueltas.
- n | integer | opcional | 1 | 1 | Usa 1 u omítelo. La generación normal devuelve una imagen; este campo no define el número de capas.
- layer_decomposition | boolean | opcional | false | - | Déjalo desactivado en la generación normal. Exige exactamente una referencia y sin metadata.background. Devuelve una base y capas PNG transparentes; layer_decomposition_options.max_images limita el total de salidas.
- layer_decomposition_options.max_images | integer | opcional | 30 | 2-100 | Límite total de salidas de la descomposición por capas, incluida la base. No es un número garantizado; el modelo decide cuántas salidas hacen falta.
- layer_decomposition_options.text_recognition | boolean | opcional | - | - | Controla el reconocimiento de texto durante la descomposición por capas. Los resultados de la tarea solo incluyen los metadatos text_recognition cuando el proveedor los devuelve.
- metadata.output_format | string | opcional | - | png | jpeg | Si se omite, usa el formato por defecto del proveedor; con transparencia se selecciona png. En capas solo afecta a la imagen base; el resto de capas siempre son PNG.
- metadata.background | string | opcional | - | auto | opaque | transparent | Solo para generación y edición. Omítelo cuando layer_decomposition=true, incluso con opaque. transparent devuelve PNG RGBA y no admite jpeg.
- metadata.watermark | boolean | opcional | - | - | Establece false para desactivar la marca de agua visible.
- metadata.response_format | string | opcional | url | url | b64_json | Forma de entrega del resultado; se recomienda url.
Errores comunes
- 400 invalid_input: disparador=Píxeles de size fuera de rango, más de 10 imágenes de referencia, o layer_decomposition sin exactamente una imagen de entrada.; solución=Valida size, el número de image_urls y las restricciones de entrada de layer_decomposition según la documentación.; reintento=Reintenta solo después de corregir el payload.
- 429 rate_limit_exceeded: disparador=La frecuencia de solicitudes, la concurrencia o la cuota alcanzan el límite de peticiones.; solución=Aplica retroceso exponencial y después revisa el ritmo de solicitudes y el uso de la cuota.; reintento=Usa retroceso de 1s/2s/4s con jitter.










