ByteDance

Seedream 5.5

seedream-5.5

Modelo de generación y edición de imágenes del equipo Seed de ByteDance, compatible con generación de imágenes a partir de texto y edición con imágenes de referencia, con la posibilidad de introducir hasta 10 imágenes de referencia; puede generar PNG con fondo transparente y ofrece tres tamaños: 1K, 1.5K y 2K

seedream-5.5

Probar seedream-5.5

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

Kling 4.0 Flash y Seedream 5.5 ya disponibles, 20 % de descuento por tiempo limitado 20% OFF · Termina 2026-11-18 Ver oferta

seedream-5.5 per image

Especificaciones	Precio unitario
1K	~~$0.0186~~ $0.01488 + ~~$0.0075~~ $0.006 Per Reference Image
1.5K	~~$0.0186~~ $0.01488 + ~~$0.0075~~ $0.006 Per Reference Image
2K	~~$0.0325~~ $0.026 + ~~$0.0075~~ $0.006 Per Reference Image

Descripción general

Este es un modelo de generación y edición de imágenes que permite generar imágenes a partir de texto únicamente y también modificar o conservar el contenido de la imagen combinándola con imágenes de referencia. La salida es una imagen estática, y se puede especificar el nivel de píxeles de 1K, 1.5K o 2K, la relación de aspecto y el formato PNG o JPEG; al elegir fondo transparente, el formato de salida se limita a PNG. Es adecuado para operaciones de comercio electrónico, diseño publicitario, producción de materiales de localización y creadores que necesitan ajustar repetidamente la imagen, y sirve para producir rápidamente imágenes de productos, carteles e imágenes de estilo realista.

Puntos clave

Generación de imágenes a partir de texto y edición de imágenes en uno: el mismo prompt puede generar una imagen nueva o, junto con una imagen de referencia, modificar o conservar una imagen existente.
Salida nativa con fondo transparente: al elegir fondo transparente y salida PNG, se obtiene directamente una imagen con zonas transparentes, lo que reduce el recorte posterior.
Varias imágenes de referencia en la generación: se pueden proporcionar de 1 a 10 imágenes de referencia http(s) públicas a la vez, cada una con facturación independiente, para guiar la generación o edición de la imagen.
Relación de aspecto y nitidez seleccionables: la salida permite especificar una de diez relaciones de aspecto y elegir entre los tres niveles de píxeles 1K, 1.5K y 2K.

Descripción de capacidades

Generación de imágenes a partir de texto: basta con introducir un prompt para generar la imagen; el prompt admite hasta 5000 caracteres. Se pueden especificar a la vez la relación de aspecto, el nivel de píxeles y el formato de salida; si se omiten, la salida se realiza en 2K y PNG.

Edición con imágenes de referencia: se proporcionan de 1 a 10 imágenes de referencia http(s) públicas y, junto con el prompt que describe lo que se debe modificar y conservar, se realizan ediciones como sustituir objetos o ajustar detalles.

Control de fondo transparente: el fondo puede ser automático, transparente u opaco; al elegir fondo transparente, el formato de salida debe ser PNG, lo que resulta adecuado para escenarios que requieren material con fondo transparente.

Configuración de especificaciones de salida: el nivel de píxeles de salida se elige entre 1K, 1.5K y 2K, la relación de aspecto se elige entre diez opciones y el formato puede ser PNG o JPEG; si se omite la relación, el modelo la selecciona automáticamente según el prompt y las imágenes de referencia.

Casos de uso

Operaciones de comercio electrónico que crean imágenes de producto con fondo transparente: con una imagen de referencia del producto y un prompt se ajustan el fondo y los detalles, y se exporta un PNG con fondo transparente para páginas de detalle de producto y materiales publicitarios.
Diseñadores que generan carteles de campaña en lote: se describe con texto el diseño y la imagen, se elige una relación vertical u horizontal y el nivel 2K, y se exporta la imagen base del cartel para el montaje posterior.
Equipos publicitarios que sustituyen elementos de la imagen: se sube una imagen publicitaria existente y se indica el objeto o la escena que se quiere sustituir, se genera la imagen modificada y se usa para comparar varias versiones de un mismo visual.
Creadores de contenido que retocan imágenes de forma continua: se sube un retrato o una imagen de producto, se ajustan la ropa, la luz y los detalles mediante varias rondas de prompts, y se exporta una imagen de estilo realista para publicar en redes sociales.

Limitaciones y recomendaciones de selección

Los niveles de píxeles de salida son solo tres: 1K, 1.5K y 2K, y 2K es el nivel de facturación predeterminado. El fondo transparente solo está disponible cuando el formato de salida es PNG; con JPEG no se pueden conservar las zonas transparentes. Las imágenes de referencia deben ser direcciones http(s) de acceso público, en número de 1 a 10, y cada una se factura por separado. El prompt admite hasta 5000 caracteres. La separación por capas de la imagen y la salida en 4K aún no están disponibles en esta interfaz, por lo que no deben considerarse especificaciones utilizables actualmente.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevo modelo disponible: Seedream 5.5 Nov 11, 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.5

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

sizestringOpcionalPredeterminado: "2K"

Controla el nivel de píxeles de la imagen de salida, toma un valor de enumeración de cadena; por defecto 2K (si se omite, se factura como 2K), 1K y 1.5K tienen el mismo precio.

Opciones:1K1.5K2K

promptstringObligatoriominLength 1maxLength 5000

Describe la escena que se desea generar, o, junto con las imágenes de referencia, explica el contenido que debe modificarse y conservarse; es la entrada principal de instrucciones para la generación y edición de imágenes.

backgroundstringOpcionalPredeterminado: "auto"

Controla el modo de fondo del resultado generado, toma un valor de enumeración de cadena; por defecto auto. Cuando se establece como fondo transparente, el formato de salida debe ser PNG.

Opciones:autotransparentopaque

image_urlsarrayOpcionalminItems 1maxItems 10

Arreglo de imágenes de referencia, proporciona de 1 a 10 URL de imágenes públicas http(s); si se omite, la imagen se genera solo a partir del mensaje de texto. Cada imagen de referencia se factura por separado; sus elementos son cadenas de enlace de imagen.

Array [ string ]

aspect_ratiostringOpcional

Controla la relación de aspecto de la salida, toma un valor de enumeración de cadena; si se omite, el modelo la selecciona automáticamente según el prompt y las imágenes de referencia.

Opciones:1:14:33:416:99:163:22:321:9

Mostrar todo (2)Mostrar menos

2:11:2

output_formatstringOpcionalPredeterminado: "png"

Controla el formato de la imagen de salida, toma un valor de enumeración de cadena; por defecto png. Cuando background es transparent, solo se admite png.

Opciones:pngjpeg

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.5",
  "input": {
    "size": "2K",
    "prompt": "…",
    "background": "auto",
    "output_format": "png"
  }
}'

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.5",
    input: {
      "size": "2K",
      "prompt": "…",
      "background": "auto",
      "output_format": "png"
    }
  }),
});
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.5",
        "input": {
          "size": "2K",
          "prompt": "…",
          "background": "auto",
          "output_format": "png"
        }
    },
)
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"
    }
  }
}