ByteDance

Seedream 5.0

seedream-5.0-flash

Modelo de generación de imágenes de nivel de producción de ByteDance, compatible con búsqueda en internet y razonamiento lógico de varios pasos, salida en 4K y edición por ejemplos, ideal para crear imágenes de productos e infografías

seedream-5.0-flash seedream-5.0-lite/image-to-image seedream-5.0-lite/text-to-image seedream-5.0-pro/image-to-image seedream-5.0-pro/text-to-image

Probar seedream-5.0-flash

Entrada

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

seedream-5.0-flash per image

Precio unitario	$0.025

Descripción general

Seedream 5.0 Flash es un modelo de generación rápida de imágenes de la serie Seedream 5.0 de ByteDance, que admite dos rutas: texto a imagen e imagen a imagen. Acepta hasta 10 imágenes de referencia, permite especificar 1K, 1.5K, 2K o un ancho y alto personalizados, y admite fondo transparente y selección de formato de salida JPEG/PNG. Es adecuado para desarrolladores que necesitan producir imágenes de productos, materiales de marketing y visuales de series en lote; se puede integrar mediante la interfaz unificada de HiAPI.ai para completar la generación y transformación con imágenes de referencia y prompts.

Aspectos destacados

Imagen a imagen con múltiples imágenes de referencia: permite enviar una URL única, Base64 o un arreglo de hasta 10 imágenes, usando un conjunto de referencias para restringir el personaje, el estilo y la composición.
Control flexible del tamaño de salida: admite presets de 1K, 1.5K, 2K o ancho y alto personalizados, con relaciones de aspecto de 1:16 a 16:1, apto para materiales horizontales y verticales.
Salida opcional con fondo transparente: en la edición de una sola imagen se puede especificar fondo transparente y salida PNG, lo que facilita superponer el material directamente en el diseño o la página.
Interruptor de optimización de prompts: incluye un modo estándar de optimización de prompts que mejora la estabilidad de la generación sin modificar la lógica de llamada.

Descripción de capacidades

Doble ruta de texto a imagen e imagen a imagen: genera imágenes solo con un prompt o, combinando imágenes de referencia, indica la posición y el contenido a modificar; una sola interfaz cubre desde la creación de nuevos materiales hasta la transformación de imágenes existentes.

Referencia y fusión de múltiples imágenes: imagen a imagen admite hasta 10 imágenes de referencia; en el prompt se puede indicar la función de cada imagen, para unificar el estilo y combinar múltiples elementos.

Salida controlable en tamaño y formato: se puede especificar de 1K a 2K o ancho y alto personalizados, y salida en JPEG o PNG; la edición con fondo transparente se restringe automáticamente a entrada de una sola imagen y formato PNG.

Interruptor de marca de agua de generación: el parámetro watermark está desactivado por defecto; se puede activar explícitamente la marca de agua de generación con IA para cumplir con los requisitos de cumplimiento de cada canal de publicación.

Casos de uso

Producción masiva de imágenes de productos por desarrolladores de comercio electrónico: usar fotos reales del producto como imágenes de referencia y, junto con prompts, generar versiones con distintos fondos y composiciones, obteniendo materiales listos para páginas de detalle y campañas publicitarias.
Extensión de visuales de series para equipos de marketing: enviar la imagen de referencia del visual principal y describir los requisitos de las variantes, para producir en lote pósteres, banners y otros materiales con tamaños y estilos coherentes.
Llamadas contextuales a imágenes en herramientas de diseño: dentro del producto, llamar a la interfaz con entrada de texto o imagen para ofrecer a los usuarios la capacidad de generar y transformar imágenes al instante.

Limitaciones y recomendaciones de selección

Como modelo Flash, está orientado a la generación de imágenes convencional y la edición con imágenes de referencia; el tamaño máximo de salida es 2K y no ofrece opciones de mayor resolución. El fondo transparente solo se limita a la edición de una sola imagen y requiere salida PNG, por lo que no se puede usar simultáneamente en escenarios de referencia con múltiples imágenes por lotes. Si se necesita mayor resolución, infografías complejas o edición de precisión a nivel de píxel, conviene evaluar versiones más potentes de la misma serie; en escenarios con requisitos de calidad de generación muy altos y que toleren mayores tiempos de espera, también se recomienda realizar una selección aparte.

Novedades

Ver el registro de cambios →

Nuevo modelo seedream-5.0-pro/image-to-image ya disponible Nov 3, 2026
Nuevo modelo Nuevo modelo disponible: seedream-5.0-pro/text-to-image Nov 3, 2026
Nuevo modelo Modelo seedream-5.0-lite/image-to-image ya disponible Nov 3, 2026

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: seedream-5.0-flash

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para seedream-5.0-flash y la ruta default; consulta la tabla de parámetros a continuación.

sizestringOpcionalPredeterminado: "2K"pattern ^(1K|1\.5K|2K|[1-9][0-9]{0,3}x[1-9][0-9]{0,3})$

Controla el tamaño de la imagen generada; se puede pasar 1K, 1.5K, 2K o un tamaño personalizado en formato "ancho x alto"; el tamaño personalizado debe tener un total de píxeles entre 921600 y 4624220, y una relación de aspecto entre 1:16 y 16:1. Por defecto 2K.

imageanyOpcionalminLength 1minItems 1maxItems 10pattern ^(https?://|data:image/)

Entrada de imagen de referencia; se puede pasar una URL individual, una imagen en Base64 o un array de hasta 10 imágenes, para guiar la generación o la edición. Obligatorio cuando background es transparent.

promptstringObligatoriominLength 1maxLength 5000

Describe el contenido de la imagen que se desea generar; al usarse junto con una imagen de referencia, se puede indicar la ubicación y el contenido a modificar.

watermarkbooleanOpcionalPredeterminado: false

Controla si se añade una marca de agua de generación con IA a la imagen de salida; pasar true para activarla. Desactivada por defecto (false).

backgroundstringOpcionalPredeterminado: "opaque"

Controla el tipo de fondo de la salida; por defecto opaque (opaco); al establecerse en transparent solo se aplica a la edición de una única imagen con canal alfa, y el formato de salida debe ser PNG o no especificarse.

Opciones:opaquetransparent

output_formatstringOpcional

Especifica el formato de archivo de la imagen de salida; si se omite, normalmente es JPEG, y PNG cuando el fondo es transparente. Cuando background es transparent, solo se admite png.

Opciones:jpegpng

optimize_prompt_optionsobjectOpcional

Grupo de ajustes de optimización de prompts, que controla las opciones relacionadas con la optimización de prompts.

modestringOpcionalPredeterminado: "standard"

Controla el modo de optimización de prompts; se emplea el modo de optimización estándar. Por defecto standard.

Opciones:standard

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5.0-flash",
  "input": {
    "size": "2K",
    "prompt": "…",
    "watermark": false,
    "background": "opaque"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "seedream-5.0-flash",
    input: {
      "size": "2K",
      "prompt": "…",
      "watermark": false,
      "background": "opaque"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "seedream-5.0-flash",
        "input": {
          "size": "2K",
          "prompt": "…",
          "watermark": False,
          "background": "opaque"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}