Cómo usar la API de Seedream 5.5

Seedream 5.5 está disponible en EmpirioLabs. Es el modelo de imagen Seedream más reciente de ByteDance, lanzado el 9 de noviembre de 2026 para text-to-image generación, ediciones que combinan hasta 10 imágenes de referencia, imágenes con verdadera transparencia hechas a partir de un prompt o de referencias, y descomposición de capas, que divide una imagen en una imagen base más hasta 99 capas transparentes y puede leer el texto en ellas. Funciona tanto en la API como en el Playground.

Mira el vídeo de lanzamiento

Todas las películas de la película fueron realizadas por Seedream 5.5 a través de la API EmpirioLabs a 2K, incluyendo un buceador apnético junto a una ballena jorobada, una bailarina de flamenco en pleno giro, un soplador de vidrio en acción y un cartel de jazz con letras. La banda sonora fue generada por ACE-Step en EmpirioLabs. Míralo en YouTube.

Cómo se compara

Lo que soporta

• De texto a imagen. Envía un prompt sin imagen.
• Edición y fusión. Adjunta de una a diez imágenes y describe el cambio, o cómo combinarlas.
• Correcciones de marcadores y coordenadas. Marca el área que se va a cambiar en la imagen de entrada con un círculo, flecha o boceto, o indica su posición exacta como un <bbox> Etiqueta en el prompt.
• Imágenes transparentes. Set Antecedentes a transparente para obtener un PNG con un canal alfa, solo a partir de un prompt o de imágenes de referencia.
• Descomposición en capas. Divide una imagen en una imagen base más hasta 99 capas PNG transparentes, cada una devuelto con su posición en la imagen base, un nombre y una descripción.
• Reconocimiento de texto. Durante una descomposición, obtén el texto de cada capa de texto impresa con sus posiciones de línea y estilo.
• Texto en la imagen. Carteles, etiquetas, carteles y letra pequeña se muestran en chino, inglés y otros 14 idiomas, incluyendo japonés, coreano, árabe, español y francés.

La salida es PNG por defecto, o JPEG, en el nivel de resolución 1K, 1,5K o 2K, o en un ancho y altura personalizados.

Generar una imagen

curl https://api.empiriolabs.ai/v1/images/generations \ -H "Autorización: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Contenido: application/json" \ -d '{ "modelo": "seedream-5-5", "prompt": "Una taza de café de cerámica junto a un pequeño cartel de pizarra que dice Oat Flat White 4.50, luz de ventana de la mañana", "aspect_ratio": "4:3", "calidad": "2K" }'

La solicitud espera la imagen terminada y la devuelve Datos. Añadir "sync": falso recuperar un trabajo de inmediato, con un job id para encuestar en ¡QUE /v1/jobs/<job_id> hasta que su Estado es terminado.

La misma llamada del SDK de Python de OpenAI, apuntando a EmpirioLabs. Entran los controles que el SDK no define extra_body:

from openai import cliente OpenAI = OpenAI(base_url="https://api.empiriolabs.ai/v1", api_key="YOUR_EMPIRIOLABS_API_KEY",) result = client.images.generate(model="seedream-5-5", prompt="Un terrario de cristal con un pequeño paisaje de musgo y una etiqueta de latón que dice Fern Garden", extra_body={"aspect_ratio": "4:3", "quality": "2K"},) print(result.data[0].url)

Haz una imagen transparente

Set Antecedentes a transparente. Funciona solo con un prompt y en ediciones de hasta 10 imágenes de referencia que no necesitan un canal alfa propio. La salida debe ser PNG:

{ "modelo": "seedream-5-5", "prompt": "Una linterna de papel rojo brillante con borlas doradas, recorte de producto aislado", "fondo": "transparente", "calidad": "1K" }

Cada imagen devuelta informa de lo que realmente contiene como Antecedentes: transparente o opaco. Salir Antecedentes en Auto, el valor predeterminado, y el modelo decide a partir del prompt y el formato de salida.

Edición con imágenes de referencia

Pasa hasta 10 URLs de imagen, URI de datos o imágenes subidas en imagen, y refierirse a ellos en el prompt por su orden:

{ "modelo": "seedream-5-5", "prompt": "Cuelga la linterna de papel roja de la imagen 1 de la rama de la imagen 2, manteniendo todo lo demás en la imagen 2 sin cambios", "imagen": [ "https://example.com/lantern.png", "https://example.com/branch-poster.png" ] }

Editar un área marcada

Para cambiar una parte de una imagen, márcalo en la entrada con un círculo, una flecha o un boceto y describe el cambio, o indica el área como un <bbox> etiqueta. Una caja es izquierda arriba derecha abajo En una cuadrícula de 0 a 1000 sobre la imagen, sea cual sea su tamaño de píxel:

{ "modelo": "seedream-5-5", "prompt": "Añade un pequeño jarrón de cristal con un solo tulipán blanco dentro <bbox>de 60 80 300 520</bbox>. Mantén todo lo demás sin cambios.", "imagen": "https://example.com/kitchen.png" }

Divide una imagen en capas

Set layer_decomposition a Cierto y adjuntar exactamente una imagen. El prompt es opcional: déjalo fuera para que el modelo elija los elementos, o nombra los elementos o regiones a separar. max_images establece el mayor número de imágenes para devolver, incluida la imagen base, de 2 a 100, y text_recognition Añade el texto de cada capa de texto impresa:

curl https://api.empiriolabs.ai/v1/images/generations \ -H "Autorización: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Contenido: application/json" \ -d '{ "modelo": "seedream-5-5", "layer_decomposition": true, "image": "https://example.com/magazine-cover.png", "max_images": 10, "text_recognition": true }'

datos[0] es la imagen base, con un z_index de 0. Cada entrada posterior es una capa PNG transparente con su orden de apilamiento, su recuadro en la imagen base en píxeles (bounding_box.absoluto) y en la cuadrícula de 0 a 1000 (bounding_box.normalizado), ambos como [izquierda, arriba, derecha, abajo], y un nombre y una descripción. Una capa de texto impresa también lleva text_recognition:

{ "url": "https://media.empiriolabs.ai/...", "z_index": 1, "width": 1723, "height": 609, "bounding_box": { "absolute": [75, 0, 995, 325], "normalizado": [69, 0, 921, 301] }, "name": "Top yellow large seriif title title Seedream", "description": "Large yellow seriif title text que dice \"Seedream\" situado en la parte superior de la composición.", "text_recognition": { "text": "Seedream", "lines": [ { "bounding_box": { "absoluto": [196, 53, 874, 231], "normalizado": [181, 49, 809, 214] }, "ejecuta": [ { "texto": "Seedream", "estilo": { "similar_font_family": "HTF Didot", "foreground_color": "#F5E25A", "negrita": falso, "cursiva": falso, "subrayado": falso, "tachado": falso, "sombra": falso, "translúcido": falso } } ] } }, "fondo": "transparente" }

Apila las capas sobre la imagen base en forma ascendente z_index para reconstruirlo, moverlo, redimensionar, recolorear o reemplazar cualquier capa primero. Con el texto reconocido, una capa puede ser reescrita, traducida o reestilizada y colocada de nuevo en la caja de su línea.

Cosas que debes saber antes de tu primera petición

• Una imagen por solicitud. Una solicitud devuelve una imagen, y n por encima de 1 devuelve un error. Envía solicitudes separadas para variaciones. La descomposición en capas es la excepción: devuelve la imagen base y sus capas juntas.
• Set max_images Para la descomposición que necesitas. Sin ella, una descomposición puede devolver hasta 30 imágenes, y cada imagen devuelta factura. Un valor mayor permite una división más fina.
• Escala cada capa a su caja. Una capa PNG no siempre tiene el tamaño de su huella en la imagen base: en el ejemplo anterior, una capa de 1723x609 llena una caja de 920x325. Escala cada capa al ancho y altura de su bounding_box.absoluto antes de colocarla en la esquina superior izquierda de la caja.
• El reconocimiento de texto lee texto impreso. La caligrafía artística y la caligrafía vuelven en capas sin text_recognition.
• La descomposición no toma Antecedentes. Sus capas son siempre PNG transparente, y ambientación Antecedentes a transparente o opaco con layer_decomposition devuelve un error.
• Un resultado transparente necesita PNG. Antecedentes: "Transparente" con output_format: "jpeg" devuelve un error.

Precios

Por imagen. Seedream 5.5 es de pago por uso y facturado por imagen devuelta en su tamaño: las imágenes de 1K y 1.5K comparten una tarifa, y las imágenes de 2K facturan a una tarifa más alta. Cada imagen de referencia añade un coste. Una descomposición de capas factura a cada imagen que devuelve, la imagen base y cada capa, a su propio tamaño. Puedes pagar conforme avanzas, o elegir un plan con asignaciones semanales. Las tarifas actuales están en el página modelo y el página de precios.

Seguridad de contenidos. Las imágenes generadas superan una comprobación automática de seguridad de contenido. Una imagen marcada como explícita no se devuelve y, como se generó antes de que se realizara la comprobación, sigue facturándose.

Empieza a construir

Prueba Seedream 5.5 en el Playground, lee la referencia completa del parámetro en el API docs, o compáralo con los otros modelos de imagen en el Catálogo de modelos. Para los modelos anteriores de la familia, véase Cómo usar la API de Seedream 5.0 Pro y Cómo usar la API Flash de Seedream 5.0.