Guía de la API de Seedream 5.0 Lite: texto a imagen y edición de imágenes

Resumen del contenido

• Seedream 5.0 Lite es el modelo de imagen de ByteDance. En HiAPI tiene dos endpoints: seedream-5.0-lite/text-to-image y seedream-5.0-lite/image-to-image, ambos a $0.035 por imagen, con el mismo precio en 2K o 4K.
• Destaca por representar texto con precisión dentro de la imagen y por la edición dirigida: cambiar un solo objeto, reemplazar el texto de un letrero o componer hasta 14 imágenes de referencia manteniendo el resto de la escena intacta.
• Cada llamada debe incluir aspect_ratio y resolution. Abre la página del modelo de texto a imagen para probarlo; las cuentas nuevas reciben 200 créditos gratuitos.

¿Texto a imagen o imagen a imagen?

	Texto a imagen	Imagen a imagen
ID del modelo	seedream-5.0-lite/text-to-image	seedream-5.0-lite/image-to-image
Campos obligatorios	prompt, aspect_ratio, resolution	Los mismos, más image_urls (1–14)
Precio	$0.035 por imagen	$0.035 por imagen, sin importar cuántas imágenes de referencia
Casos de uso	Carteles, menús, packaging, infografías	Cambio de color, reemplazo de texto, integración de productos en escenas

Precio en tiempo real de HiAPI, verificado el 19 de octubre de 2026. Las tareas fallidas no se cobran.

4K cuesta lo mismo que 2K, así que solicita 4K directamente cuando necesites tamaño de impresión. Con $1 se generan aproximadamente 28 imágenes.

Texto a imagen: texto representado con precisión

Pon entre comillas cada palabra que quieras renderizar e indica la posición de cada cadena:

Un cartel de estilo serigrafía dibujado a mano para un ficticio festival gastronómico nocturno, título grande en caligrafía china "夜市食堂" en la parte superior, subtítulo en inglés "NIGHT MARKET CANTEEN" justo debajo en una sans-serif condensada, una línea de fecha "OCT 17-19 · RIVERSIDE PIER" en la parte inferior, resplandor cálido de farolillos sobre puestos de comida abarrotados, vapor que se eleva de cestas de bambú, paleta limitada de bermellón, crema y azul tinta, grano de impresión visible, composición de cartel vintage

Generar este cartel →

seedream-5.0-lite/text-to-image, 2K, $0.035.

El título en chino, el subtítulo en inglés y la línea de fecha aparecen tal como se escribieron. El mismo patrón sirve para pizarras de menú, etiquetas de precio y packaging; mantén el texto en unas seis líneas o menos. Para ver cinco patrones más (incluido un menú con cada precio correcto), consulta Recetas de prompts de Seedream 5.0 Lite.

Imagen a imagen: cambia solo un detalle y conserva el resto

Patrón: una frase que describa el cambio y luego nombra todo lo que debe permanecer intacto.

Cambio de color localizado. Imagen original:

Cambia esta taza de cerámica mate blanca por una taza de gres azul cobalto profundo con acabado brillante y reflejos, mantén exactamente igual el vapor, la mesa de roble, el cuaderno abierto, la pluma estilográfica, la planta suculenta, la iluminación y el ángulo de cámara, fotorrealista

seedream-5.0-lite/image-to-image, una imagen de referencia, 3:2, 2K, $0.035.

Reemplazo de texto en letrero.

Reemplaza el texto del letrero de madera sobre la puerta por "BAKERY CORNER", mantén el mismo estilo de fuente serif dorada y el mismo tamaño de letra, mantén exactamente igual la forma del letrero y la textura de la madera, la fachada de ladrillo, las ventanas iluminadas, el olivo y la luz nublada, fotorrealista

seedream-5.0-lite/image-to-image, una imagen de referencia, 3:2, 2K, $0.035.

Composición de dos imágenes. Haz referencia a las imágenes según su orden en image_urls:

Toma la mochila de cuero de la primera imagen y colócala sobre la roca de granito plana de la escena de campamento de la segunda imagen, apoyada de forma natural en un ligero ángulo, con la iluminación ajustada para coincidir con la cálida luz solar de la hora dorada, y proyectando una sombra suave sobre la roca, mantén intactos el anillo de piedra para el fuego, el bosque de pinos y los picos de las montañas, composición fotorrealista

seedream-5.0-lite/image-to-image, dos imágenes de referencia, 3:2, 2K, $0.035.

Configura aspect_ratio igual que la entrada. Si solicitas una forma de encuadre distinta, el recorte puede consumir parte del efecto de la edición.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/text-to-image",
    "input": {
      "prompt": "A cafe chalkboard menu listing exactly three items: '\''FLAT WHITE 4.50'\'', '\''COLD BREW 5.00'\'', '\''CROISSANT 3.80'\''",
      "aspect_ratio": "3:4",
      "resolution": "2K"
    }
  }'

Recibirás un taskId. Consulta GET https://api.hiapi.ai/v1/tasks/{taskId} hasta que data.status sea success y luego descarga data.output[0].url. Los enlaces caducan, así que guarda el archivo de inmediato.

Para editar, cambia el modelo a seedream-5.0-lite/image-to-image y añade "image_urls": ["https://your-cdn.example.com/input.jpg"].

Python: primero genera y luego edita

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=300, **inp):
    body = {"model": model, "input": inp}
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Generate a packshot
shot = generate("seedream-5.0-lite/text-to-image",
                prompt="Studio photo of a matte-black tea tin labeled 'HILLFOG' on slate, no other text",
                aspect_ratio="1:1", resolution="2K")

# Then make a colorway from it; the generated URL works as a reference
green = generate("seedream-5.0-lite/image-to-image",
                 prompt="Recolor the tin to deep forest green, keep the label, slate and lighting unchanged",
                 image_urls=[shot], aspect_ratio="1:1", resolution="2K")

with open("green.jpg", "wb") as f:
    f.write(requests.get(green).content)

Si vas a reutilizar los resultados más adelante, descarga cada resultado en cuanto esté listo; los enlaces de salida caducan.

Parámetros

Campo	Obligatorio	Valores	Descripción
prompt	Sí	4–3,000 caracteres	Pon entre comillas el texto que quieras renderizar
aspect_ratio	Sí	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	Manténlo igual que la entrada al editar
resolution	Sí	2K, 4K	En mayúsculas; mismo precio
image_urls	Solo imagen a imagen	1–14 URL	jpeg, png o webp, máximo 10 MB cada una

No hay seed, negative_prompt ni output_format.

Errores comunes

Todos estos errores se devuelven como HTTP 400 al enviar, así que no se crea ninguna tarea y no se cobra nada:

• aspect_ratio: missing required field / resolution: missing required field: ambos son obligatorios, aunque la documentación enumere valores predeterminados.
• resolution: value must be one of '2K', '4K': no hay 1K. Usa mayúsculas.
• image_urls: maxItems: got 15, want 14: máximo 14 imágenes de referencia.
• prompt: minLength: got 2, want 4: el prompt necesita al menos 4 caracteres.
• additional properties 'output_format' not allowed: ese campo no existe en Lite.

¿Lite, Flash o Pro?

Modelo	Precio por imagen	Casos de uso
Seedream 5.0 Flash	$0.025	Cuando lo más importante es el volumen y la velocidad
Seedream 5.0 Lite	$0.035 tanto en 2K como en 4K	Texto en imagen, edición precisa, 4K sin coste adicional
Seedream 5.0 Pro	$0.05 (1K) / $0.10 (2K)	Cuando el recurso final necesita el máximo detalle

Para ver una prueba comparativa con el mismo prompt entre los dos niveles más económicos, consulta Comparativa de Seedream 5.0 Flash y Lite. Para los precios completos, consulta Precios de la API de Seedream 5.0.

Preguntas frecuentes

¿Se cobra extra por cada imagen de referencia?

No. Imagen a imagen cuesta $0.035 por salida, ya envíes 1 o 14 imágenes de referencia.

¿Puede representar texto en chino?

Sí. El cartel de arriba incluye en la misma imagen un título en chino y un subtítulo en inglés. Basta con poner entre comillas cada cadena y anclar su posición.

¿Mantendrá mi producto exactamente igual?

Conserva lo que nombres. Enumera todos los elementos que deben permanecer (forma, etiqueta, iluminación, ángulo de cámara); cualquier cosa que no menciones puede cambiar.

¿2K o 4K?

Cuestan lo mismo. En 2K el lado largo mide unos 2,300 px; en 4K, unos 4,096 px. Los archivos en 2K son más pequeños y más cómodos de revisar durante la iteración; cambia a 4K cuando necesites impresión.