ByteDance

Seedream 4.5

seedream-4.5/text-to-image

Modelo de imágenes de nivel comercial de ByteDance, especializado en iluminación y sombras cinematográficas, coherencia de personajes entre tomas y edición con referencias de múltiples imágenes; ideal para generar imágenes de alta resolución para materiales de comercio electrónico y marketing

seedream-4.5/image-to-image seedream-4.5/text-to-image

Probar seedream-4.5/text-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

seedream-4.5/text-to-image per image

Precio unitario	$0.045

Descripción general

La línea de generación de imágenes a partir de texto Seedream 4.5 está orientada a desarrolladores que necesitan resultados visuales controlables y reutilizables, generando imágenes de estilo fotorrealista directamente a partir de indicaciones de texto. Admite dos resoluciones nativas, 2K y 4K, y ocho relaciones de aspecto que van de 1:1 a 21:9, con un límite de 3000 caracteres por indicación. Es adecuada para tareas de generación de imágenes por lotes con requisitos claros de calidad y composición, como imágenes de producto para comercio electrónico, materiales de marketing, conceptos audiovisuales y borradores de diseño; basta con llamar a la interfaz unificada de HiAPI.ai para integrarla en los flujos de generación existentes.

Puntos clave

Salida directa en alta resolución nativa 2K/4K: la salida puede ser 2K estándar o 4K ultraalta definición, lo que elimina el paso de ampliar imágenes generadas a baja resolución.
Ocho relaciones de aspecto que cubren los formatos más habituales: se puede especificar directamente desde la imagen cuadrada 1:1 hasta el formato panorámico 21:9, adaptándose a distintos formatos de comercio electrónico, redes sociales y banners.
Iluminación cinematográfica y textura realista: los estudios muestran que simula la niebla volumétrica y las sombras complejas de la fotografía real, por lo que el resultado final se acerca más a una toma real.
Indicaciones más largas para descripciones complejas: el límite de 3000 caracteres permite detallar en una sola solicitud la escena, los materiales y las relaciones espaciales.

Descripción de capacidades

Generación de imágenes realistas a partir de texto: basta con introducir una descripción textual para producir una imagen de estilo realista, convirtiendo la descripción creativa directamente en un borrador visual entregable y reduciendo los costes de dibujo o fotografía manual.

Resolución y formato controlables: mediante los parámetros resolution y aspect_ratio se especifica la salida en 2K o 4K y una de las ocho relaciones de ancho y alto; con una sola llamada se obtiene una imagen ajustada al formato objetivo, sin necesidad de recortes posteriores.

Interpretación de indicaciones complejas: las indicaciones de hasta 3000 caracteres pueden albergar descripciones por capas de escena, sujeto y composición; los estudios muestran que esta versión mejora el seguimiento de las indicaciones y la precisión de los detalles respecto a la generación anterior.

Calidad de imagen de nivel comercial: los estudios muestran que su iluminación, la textura de la piel y el renderizado de texto se acercan a la percepción fotográfica, por lo que resulta apta para entregas externas y no solo como borrador.

Casos de uso

Operaciones de comercio electrónico: generación por lotes de imágenes de producto en contexto: describe con texto el producto y la atmósfera de la escena para producir imágenes principales y de ambiente en alta resolución listas para publicar, destinadas a las páginas de detalle del producto y a los materiales de campaña.
Equipos de marketing: carteles promocionales con texto: introduce los requisitos de maquetación y copy para generar carteles y banners con texto claro y legible, listos para su publicación en redes sociales y espacios publicitarios.
Cine y videojuegos: arte conceptual y storyboards: genera imágenes por lotes a partir de descripciones del guion o de la ambientación para producir diseños conceptuales y fotogramas de storyboard destinados a la discusión previa y a la confirmación de la dirección artística.
Equipos de diseño: borradores visuales en múltiples formatos: gracias a las distintas relaciones de aspecto y a las resoluciones 2K/4K, produce rápidamente borradores visuales adaptados a diferentes dispositivos para propuestas al cliente e iteraciones.

Limitaciones y recomendaciones de selección

Esta línea solo acepta entrada de texto; si se necesita editar o componer a partir de imágenes existentes como referencia, debe elegirse la línea de imagen a imagen de la misma serie. Los estudios mencionan que la generación en 4K exige una gran capacidad de cómputo y presenta una latencia de generación elevada, por lo que en escenarios sensibles al tiempo real conviene evaluar el coste de espera de la generación. Las descripciones de capacidades son en su mayoría mejoras relativas a Seedream 4.0 y carecen de comparaciones independientes con otros modelos de la misma época; al elegir, se recomienda probar el rendimiento con muestras del propio negocio antes de decidir.

Preguntas frecuentes

Ver todas las preguntas →

¿Cuál es la diferencia entre imagen a imagen y texto a imagen en Seedream 4.5?

El endpoint de imagen a imagen utiliza la imagen que subes como base para la edición, ideal para cambiar colores, sustituir fondos, reiluminar, convertir estilos y componer varias imágenes; mientras que texto a imagen genera la escena desde cero únicamente a partir del texto. Cuando necesites conservar el sujeto, la composición o el texto dentro de la imagen, deberías dar prioridad al modelo actual de imagen a imagen.
¿Cuántas imágenes de referencia admite como máximo Seedream 4.5?

En cada solicitud se pueden subir de 1 a 14 imágenes JPEG, PNG o WebP, con un tamaño máximo de 10 MB por archivo; no se admite SVG. En tareas con varias imágenes, se puede especificar la función de cada imagen en el Prompt con "image 1" e "image 2"; el orden debe coincidir con el del array image_urls.
¿Cómo se factura la edición de imágenes con Seedream 4.5? ¿Afecta el precio la cantidad de imágenes de referencia?

Se factura por la imagen de salida generada con éxito, no por la cantidad de imágenes de referencia. Actualmente 2K y 4K usan la misma tarifa pública; el importe exacto se rige por el precio en tiempo real de la página del modelo y el registro de tareas.
¿Cómo se puede hacer que Seedream 4.5 conserve el sujeto, la composición o el texto de la imagen?

En el Prompt hay que indicar claramente tanto "qué se debe cambiar" como "qué debe permanecer sin cambios", por ejemplo, conservar el contorno del sujeto, el ángulo de cámara, las sombras de contacto, la disposición de la tienda o el texto caligráfico. Primero revisa el resultado en el Playground; para materiales con texto de marca y requisitos de maquetación estrictos, se recomienda mantener una revisión humana.

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-4.5/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para seedream-4.5/text-to-image y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 4maxLength 3000

Prompt de texto que describe el contenido de la imagen que se desea generar, en formato de cadena, con una longitud máxima de 3000 caracteres.

resolutionstringObligatorioPredeterminado: "2K"

Nivel de nitidez de la imagen de salida, en formato de cadena; 2K es calidad estándar y 4K es ultraalta definición; por defecto, 2K.

Opciones:2K4K

aspect_ratiostringObligatorioPredeterminado: "1:1"

Relación de aspecto de la imagen generada, en formato de cadena; por defecto, 1:1.

Opciones:1:14:33:416:99:162:33:221:9

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-4.5/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }
}'

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-4.5/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "2K",
      "aspect_ratio": "1:1"
    }
  }),
});
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-4.5/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "2K",
          "aspect_ratio": "1:1"
        }
    },
)
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"
    }
  }
}