Cómo usar la API Flash de Seedream 5.0

Seedream 5.0 Flash está disponible en EmpirioLabs. Es el modelo rápido de imágenes Seedream de ByteDance para generación text-to-image, editaciones que combinan hasta 10 imágenes de referencia, cortes precisos colocados con coordenadas o marcadores dibujados, y descomposición de capas, que divide una imagen en una imagen base más hasta 16 capas transparentes. Funciona tanto en la API como en la Playground.

Mira el vídeo de lanzamiento

Cada imagen de la película es una salida real de Seedream 5.0 Flash. La banda sonora fue generada por ACE-Step en EmpirioLabs.

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.
• Descomposición en capas. Divide una imagen en una imagen base más hasta 16 capas PNG transparentes, cada una devuelto con su posición en la imagen base, un nombre y una descripción.
• Fondos transparentes. Edita una imagen que ya tenga un canal alfa y mantén la transparencia en el resultado.
• Texto en la imagen. Los carteles, etiquetas y carteles se muestran en chino, inglés y otros 14 idiomas, incluyendo japonés, coreano, árabe, español y francés.

La salida es PNG o JPEG en los niveles 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-0-flash", "prompt": "Un festival de farolillos de papel sobre un río al anochecer, reflejos en el agua", "aspect_ratio": "16:9", "calidad": "2K", "sincronización": verdadero }'

Sincronización y asincrónico. Con "sync": verdadero La solicitud permanece abierta y devuelve la imagen terminada en Datos. Sin él, la respuesta es un trabajo con un job id y a poll url. Encuesta ¡QUE /v1/jobs/<job_id> hasta que 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",) resultado = client.images.generate(model="seedream-5-0-flash", prompt="Un festival de farolillos de papel sobre un río al anochecer, reflejos en el agua", extra_body={"sync": True, "aspect_ratio": "16:9", "quality": "2K"},) print(result.data[0].url)

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:

{ "model": "seedream-5-0-flash", "prompt": "Coloca la taza de la imagen 1 sobre la mesa de la imagen 2, manteniendo la iluminación de la imagen 2", "image": [ "https://example.com/cup.png", "https://example.com/table.jpg" ], "sync": true }

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-0-flash", "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", "sincronización": verdadero }

Las etiquetas también funcionan entre imágenes, por ejemplo para colocar al sujeto de una región de la imagen 1 en una región de la imagen 2.

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.

curl https://api.empiriolabs.ai/v1/images/generations \ -H "Autorización: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Contenido: application/json" \ -d '{ "modelo": "seedream-5-0-flash", "layer_decomposition": true, "image": "https://example.com/perfume-ad.png", "prompt": "Separa el frasco de perfume, su etiqueta y el haz de luz", "sync": 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 descripción:

{ "URL": "https://media.empiriolabs.ai/...", "z_index": 4, "ancho": 476, "altura": 1024, "bounding_box": { "absoluto": [1181, 268, 1657, 1292], "normalizado": [419, 169, 588, 815] }, "nombre": "Cuerpo principal del frasco de perfume", "descripción": "Un frasco cuadrado transparente con tapa dorada facetada..." }

Apila las capas sobre la imagen base en forma ascendente z_index para reconstruirla, mover, redimensionar, recolorear o reemplazar cualquier capa primero. Una capa también puede ser la entrada para una nueva solicitud, por ejemplo, para recolorear un elemento y mantener su transparencia.

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.
• Escala cada capa a su caja. Una capa PNG no siempre es el tamaño de su huella en la imagen base, y una capa de texto puede volver a ser varias veces mayor. Escala cada capa al ancho y altura de su bounding_box.absoluto antes de colocarla en la esquina superior izquierda de la caja.
• El prompt decide cuántas capas vuelven. Sin aviso, el modelo separa cada elemento que encuentra, y cada imagen devuelta factura. Nombra los elementos que necesitas o pone sus regiones como <bbox> etiquetas, para mantener el resultado en esas.
• Vuelve a intentar una descomposición en capas que no se haya podido procesar. Una descomposición de capas falla ocasionalmente con un error que indica que el contenido de la imagen no pudo ser procesado. Envía la misma petición de nuevo.
• No hay optimización rápida de prompts. prompt_optimization_mode: "rápido" de Seedream 5.0 Pro devuelve un error en Flash. Deja el control fuera.
• Un resultado transparente necesita una entrada transparente. Antecedentes: "Transparente" funciona en una edición de exactamente una imagen que ya tiene un canal alfa, como una capa de una descomposición, con output_format Establecido a png. La salida JPEG devuelve un error.

Precios

Por imagen. El Flash de Seedream 5.0 es de pago por uso y se factura por imagen devuelta, a una tarifa por cada nivel de resolución. Las imágenes de referencia no añaden coste adicional. Una descomposición de capas factura cada imagen que devuelve, la imagen base y cada capa, al mismo precio. No se requiere suscripción. 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.0 Flash 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 la categoría Pro de la misma familia, véase Cómo usar la API de Seedream 5.0 Pro.