Cómo usar la API de Seedgream 4.5

CometAPI
AnnaDec 9, 2025
Cómo usar la API de Seedgream 4.5

Seedream 4.5 es la evolución más reciente de la familia Seedream de modelos de texto a imagen/edición de imágenes (desarrollado en el marco de la investigación de Byte/BytePlus). Se está desplegando en endpoints oficiales de BytePlus y múltiples plataformas de terceros —incluido el acceso integrado a través de pasarelas multimodelo como CometAPI— y aporta mejoras en la consistencia del sujeto, la tipografía/renderizado de texto y la fidelidad de edición con múltiples imágenes.

Este artículo es una guía práctica y profesional para usar la API de Seedream 4.5. Obtendrás pasos de configuración, patrones de autenticación y solicitud, buenas prácticas de prompts y parámetros, flujos de edición y multiimagen, manejo de errores, patrones de despliegue y consideraciones legales/de seguridad.

¿Qué es Seedream 4.5?

Seedream 4.5 es la última iteración de la familia Seedream: un modelo multimodal de generación y edición de imágenes diseñado para creación de texto a imagen de alta fidelidad y edición de imágenes con conocimiento del contexto (image-to-image, edición con múltiples referencias, inpainting/outpainting, tipografía y manejo de texto denso). En comparación con versiones anteriores de Seedream, 4.5 se centra en mejorar la consistencia del sujeto en flujos multiimagen, una preservación más estricta de detalles de referencia, mayor fidelidad tipográfica (texto en imágenes) y mejor calidad de salida hasta 4K/ultra HD en configuraciones de “alta calidad”. Estas mejoras forman parte de una arquitectura escalada y una actualización del ajuste de prompts/heurísticas del motor.

Por qué esto importa: 4.5 está diseñado explícitamente para manejar tareas creativas profesionales —variaciones de productos por lotes, ediciones multiimagen coherentes con la marca y activos para impresión en alta resolución— a la vez que permite un control más fino con imágenes de referencia y operaciones de edición especializadas.

Capacidades principales

  • Generación de texto a imagen (individual y por lotes): genera de 1 a 15 imágenes por llamada a la API, con modos de calidad seleccionables (Basic vs High) que compensan velocidad y resolución.
  • Edición de imágenes (i2i / inpainting / outpainting): usa una o más imágenes de referencia; preserva detalles y relaciones espaciales entre múltiples referencias.
  • Mezcla multirreferencia y copia de elementos: se pueden usar hasta ~10 imágenes de referencia en un solo trabajo para trasplantar elementos manteniendo coherencia de iluminación/perspectiva.
  • Representación tipográfica/de texto denso de alta calidad: mejor manejo de imágenes con texto o señalética (útil para maquetas, etiquetas de producto, capturas de UI).
  • Salida en streaming/progresiva: algunos endpoints de despliegue admiten resultados en streaming para que los clientes reciban resultados parciales mientras continúa la generación.

¿Cómo uso la API de Seedream 4.5 a través de CometAPI?

A continuación tienes un recorrido práctico y listo para copiar y pegar para generar imágenes mediante CometAPI (un agregador que expone el modelo Seedream 4.5 como un parámetro de modelo). Usa CometAPI cuando quieras una única clave de API para acceder a decenas/centenares de modelos y una superficie REST estable y fácil de integrar. La documentación de CometAPI muestra el alias de modelo doubao-seedream-4-5-251128 y un endpoint estándar de generación de imágenes.

Pasos de alto nivel

  1. Regístrate en CometAPI y obtén una clave de API.
  2. Usa el endpoint de generación de imágenes (POST https://api.cometapi.com/v1/images/generations) con el parámetro de modelo establecido en el identificador de Seedream 4.5 (ejemplo: doubao-seedream-4-5-251128).
  3. Incluye el prompt, imágenes de referencia opcionales (URLs o cargas multipart según el agregador), tamaño/calidad de salida y otros parámetros.
  4. Recibe una respuesta JSON que contiene URLs de imágenes generadas (o base64) y metadatos.

Tipos de solicitudes y modos

Seedream 4.5 suele admitir:

  • Texto → Imagen (prompts de texto → imágenes nuevas)
  • Imagen → Imagen (imágenes de referencia + prompts para transformaciones con estilo)
  • Edición de imagen / Inpainting (máscara + instrucciones de edición para cambios puntuales)
    las APIs alojadas admiten modos de tareas asíncronas (enviar trabajo → sondear con taskId), lo que encaja con renders de larga duración y flujos por lotes. Los enlaces generados suelen ser de tiempo limitado (p. ej., válidos 24 horas en algunas pasarelas), así que planifica el almacenamiento/exportación.

curl example (text-to-image, single prompt)

curl -X POST "https://api.cometapi.com/v1/images/generations" \
  -H "Authorization: Bearer COMETAPI_KEY_GOES_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic portrait of a cyberpunk fox in neon rain, 4k, detailed lighting, film grain",
    "n": 3,
    "width": 2048,
    "height": 2048,
    "quality": "high",     # or "basic"
    "seed": 12345,
    "style": "photorealistic"
  }'

Notas

  • Reemplaza COMETAPI_KEY_GOES_HERE con tu clave de CometAPI.
  • El parámetro n genera múltiples variaciones en una sola llamada (ahorra overhead).
  • quality: "high" normalmente se asocia a mayor resolución/mayor coste de cómputo (a menudo compatible con 4K).

Ejemplo en Python requests (texto a imagen + guardado de resultados)

import requests, base64, os

API_URL = "https://api.cometapi.com/v1/images/generations"
API_KEY = os.environ.get("COMETAPI_KEY")  # set env var for safety

payload = {
  "model": "doubao-seedream-4-5-251128",
  "prompt": "Studio shot of a ceramic mug on a wooden table, warm natural light, ultra-detailed, 2k",
  "n": 2,
  "width": 1024,
  "height": 1024,
  "quality": "basic"
}

resp = requests.post(API_URL, json=payload, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
resp.raise_for_status()
data = resp.json()

# Example: each item has 'b64_json' or 'url' depending on provider
for i, item in enumerate(data.get("data", [])):
    img_b64 = item.get("b64_json")
    if img_b64:
        img_bytes = base64.b64decode(img_b64)
        with open(f"seedream_result_{i}.png", "wb") as f:
            f.write(img_bytes)
    else:
        print("Image URL:", item.get("url"))

¿Por qué este patrón? Los agregadores suelen devolver una carga base64 o URLs alojadas; el código maneja ambos. El endpoint normalmente devolverá un task_id. Sondea el endpoint GET /tasks/{task_id} hasta que el estado sea succeeded y luego descarga el resultado. Muchos proveedores incluyen SDKs con helpers integrados para este patrón.

¿Cómo optimizar la calidad de imagen y mantener el texto legible?

  1. Usa imágenes de referencia para lograr contexto y concordancia de color consistentes.
  2. Menciona la tipografía explícitamente en el prompt (familia, grosor, alineación) y considera añadir el texto exacto como superposición en un segundo paso para asegurar legibilidad.
  3. Ejecuta un proceso en dos pasos: (a) genera la composición base; (b) vuelve a renderizar o edita en una segunda pasada centrada en primeros planos o áreas de etiquetas con mayor resolución.

¿Cómo debes redactar prompts para Seedream 4.5?

Principios de redacción de prompts

  • Sé explícito: enumera sujeto, acción, estilo, lente/cámara, hora del día y paleta de colores deseada.
  • Usa anclajes de identidad: si necesitas la misma cara/objeto en varias imágenes, incluye descriptores persistentes (p. ej., “la misma mujer con cabello corto y ondulado, chaqueta verde, cicatriz en la ceja izquierda”) y proporciona de 1 a 3 imágenes de referencia. La fusión multirreferencia de Seedream 4.5 ha mejorado, pero los anclajes ayudan.
  • Prompts negativos: declara explícitamente qué evitar (p. ej., “sin texto”, “sin marcas de agua”, “sin extremidades extra”).
  • Híbrido corto + largo: da una instrucción canónica breve y luego amplíala con algunas líneas de detalles y restricciones.

Plantillas de prompts de ejemplo

Producto en hero (fotorrealista): "Una toma hero limpia de un altavoz inalámbrico negro mate colocado sobre una mesa blanca, iluminación de softbox, 50 mm, poca profundidad de campo, fondo de estudio, fotorrealista, sin texto"

Ilustración de fantasía (estilizada): "Paisaje de fantasía épico, castillo de vidrio imponente en un acantilado, hora dorada, niebla volumétrica, pictórico, altamente detallado, concept art"

Edición de imagen (eliminar objeto): "Elimina a la persona de la izquierda y extiende el fondo para rellenar el espacio, mantén la iluminación consistente, sin artefactos"

Maqueta con mucha tipografía: "Maqueta de pantalla de aterrizaje de app móvil en un iPhone 14, con el texto 'Lanzar ahora' en Gotham Bold, haz que el botón sea verde y mantén las sombras suaves"

Retrato de personaje: "Retrato heroico de una guerrera, iluminación cinematográfica de contorno, lente de retrato de 85 mm, textura de piel ultradetallada, pecas naturales, armadura de cuero, fondo neutro, fotorrealista."

Prompts multiimagen y de referencia

Al usar edición multiimagen, especifica qué imagen de referencia corresponde a qué parte del prompt. Seedream 4.5 mejora al identificar el sujeto principal entre varias referencias, pero ser explícito (p. ej., “usa image_1 para el rostro, image_2 para la textura de la ropa”) ofrece mejores resultados.

Selección de salida y posprocesado

  • Genera N variantes y aplica filtros objetivos: puntuación de similitud facial, comparación de histogramas de color, OCR de tipografía para verificar la precisión del texto.
  • Automatiza umbrales de control de calidad para derivar salidas por debajo del umbral a retoque manual.
  • Delegar la tipografía final a herramientas de maquetación si necesitas texto al píxel: usa el modelo para fondos e imágenes, luego compón el texto preciso en post. Esto reduce la necesidad de depender de la fidelidad del texto del modelo para activos de marketing.

¿Cómo realizar edición de imágenes, inpainting y composición multiimagen?

Flujo de trabajo de edición de imágenes

  1. Sube las imágenes de referencia al proveedor o envíalas inline con la solicitud.
  2. Proporciona una máscara (imagen binaria) para inpainting o una anotación de contorno para ediciones puntuales.
  3. Envía un prompt de edición que aclare qué regiones cambiar y cuáles preservar.

Muchas APIs admiten modos de edición de imagen única y composición multiimagen; 4.5 está explícitamente ajustado para preservar la identidad del sujeto y mejorar la coherencia multiimagen.

Ejemplo: Payload de inpainting (seudocódigo JSON)

{
  "model": "seedream-4.5",
  "mode": "image_edit",
  "image_url": "https://.../original.png",
  "mask_url": "https://.../mask.png",
  "prompt": "Replace background with a sunset beach — keep subject untouched, maintain original lighting on subject",
  "guidance": 9,
  "steps": 40
}

Consejos para una edición multiimagen consistente

  • Usa la misma seed para renders relacionados a fin de mantener la consistencia entre fotogramas.
  • Mantén descriptores de cámara consistentes en los prompts (p. ej., “85 mm retrato, softbox, 3/4”) para conservar el punto de vista.
  • Al editar rostros, solicita cláusulas de preservación de grano fino (“preservar estructura facial, cambiar solo el color del cabello”) para reducir deriva de identidad.

Mejores prácticas al usar Seedream 4.5

¿Cómo solucionas problemas comunes?

Aquí tienes pasos prácticos de solución cuando los resultados no son los esperados:

Rostros borrosos / detalles incorrectos

Aumenta la especificidad del prompt para detalles faciales (edad, expresión, iluminación), proporciona imágenes de referencia de mayor calidad o intenta una instrucción explícita de “preservar rostro” y reduce la strength de edición para conservar más del original. Seedream 4.5 mejora el realismo facial, pero las entradas siguen siendo determinantes.

El texto es ilegible o distorsionado

Proporciona texto vectorial o ráster como superposición separada si necesitas tipografía al píxel; de lo contrario, usa configuraciones de mayor resolución e instrucciones de estilo explícitas como “renderizar texto legible: sí”. 4.5 mejora el manejo de texto denso respecto a versiones previas, pero la perfección tipográfica puede requerir composición en post.

Iluminación o composición inconsistente en lote

Usa un prompt con plantilla que fije menciones de iluminación/cámara, o genera dentro de una sola llamada por lote para incrementar la consistencia. BytePlus y CometAPI ofrecen patrones de inferencia por lotes por ese motivo.

Notas finales y próximos pasos

Seedream 4.5 es un modelo de imagen maduro y orientado a producción con mejoras explícitas dirigidas a flujos creativos reales: mejor consistencia, texto y renderizado facial mejorados y soporte multirreferencia. Usa CometAPI o agregadores similares cuando necesites experimentación rápida y flexibilidad multimodelo.

Los desarrolladores pueden acceder a Seedream 4.5 a través de CometAPI; the latest model version siempre se actualiza con el sitio web oficial. Para comenzar, explora las capacidades del modelo en el Playground y consulta la API guide para instrucciones detalladas. Antes de acceder, asegúrate de haber iniciado sesión en CometAPI y haber obtenido la clave de API. CometAPI ofrece un precio mucho más bajo que el oficial para ayudarte a integrar.

¿Listo para empezar?→ Free trial of Seedream 4.5 !

Si quieres conocer más consejos, guías y novedades sobre IA, síguenos en VK, X y Discord!

Leer Más

500+ Modelos en Una API

Hasta 20% de Descuento