Edición con Seedream 4.0: roles de referencia, tamaños exactos e imágenes a 0,03 $

La edición con Seedream 4.0 admite de 1 a 10 imágenes de referencia y devuelve una imagen en el tamaño que elijas entre dieciséis preajustes. Cuesta 0,03 $ por imagen con cualquier tamaño y cualquier número de referencias. No hay máscara, control de intensidad ni seed, así que todo el control lo lleva el prompt: úsalo para cambiar ropa, fondo y luz o para convertir un boceto en un render, no para ediciones en las que cualquier otro píxel deba quedar intacto.

SpicyAPI no añade ningún filtro de contenido adicional a nivel de plataforma en este editor. En nuestras pruebas de septiembre de 2026, algunas ediciones para adultos de mayor intensidad volvieron más suaves de lo pedido mientras la tarea figuraba como completada, así que revisa la imagen antes de usarla.

Asigna una tarea a cada referencia

Envía las imágenes en image_urls y refiérete a ellas por orden: imagen uno, imagen dos, etc. Una referencia que no mencionas no se ignora: se mezcla en el resultado. Da a cada fuente una sola tarea e indica qué debe conservarse.

Para un cambio de vestuario, sube una imagen aprobada de un adulto ficticio con una chaqueta sencilla, elige 1728*2304 y usa:

Conserva de la imagen uno el rostro, el peinado, la pose, las manos, el punto de vista de la cámara y el fondo del adulto ficticio. Sustituye solo la chaqueta por un blazer de terciopelo burdeos opaco sobre la camisa crema existente. Mantén el largo original de la chaqueta y la forma de los hombros. Muestra un brillo suave de terciopelo bajo la luz existente, con solapas definidas y sin joyas ni texto nuevos.

«Haz el atuendo más lujoso» deja abierta la confección y puede devolver un disfraz distinto. Para igualar un blazer concreto, añádelo como imagen dos y cambia la frase del material por: «La imagen dos define el corte, las solapas y la tela del blazer burdeos. Usa solo esa prenda; mantén la persona, la pose y la escena de la imagen uno.» Recorta la foto de la prenda para que muestre solo la ropa, porque una foto de moda completa trae también su rostro, su cuerpo y su iluminación.

SpicyAPI acepta hasta diez referencias. Cada archivo puede ser JPG, PNG, WEBP o GIF de hasta 10 MB, para imágenes sobre las que tengas derechos.

Elige el tamaño exacto

Seedream 4.0 recibe size como una cadena width*height, no los campos resolution y aspect_ratio de los modelos 5.0. El valor predeterminado es 2048*2048. El resultado se reconstruye en el preajuste elegido en lugar de recortarse de la fuente, así que una fuente vertical enviada con el cuadrado predeterminado se recompone y su encuadre puede cambiar. Ajusta el tamaño a la forma de la fuente.

1024*1024 es el preajuste restante. Se rechazan otras dimensiones. 4096*2304 es el encuadre más grande entre los editores Seedream de SpicyAPI; 5.0 Lite llega como máximo a 3136*1344.

No hay un preajuste 4:5. Para una tarjeta social 4:5, usa 1728*2304 y deja margen para un recorte ligero, o cambia a Seedream 5.0 Flash (0,029 $ por imagen) o 5.0 Pro, que aceptan aspect_ratio: 4:5. Pro empieza en 0,036 $ por imagen y cuesta más en 2K y con referencias adicionales.

Prueba primero en el Playground

Ejecuta la edición en el Playground antes de escribir código: un resultado que aquí sale mal también saldrá mal desde la API, y la solución es un mejor prompt o una mejor referencia.

1. Abre la página de edición de Seedream 4.0 y quédate en la pestaña Playground, en la vista Form. Para ejecutar, inicia sesión con una cuenta con saldo.
2. Añade tus fuentes en Images: suelta un archivo o pega un enlace con Add URL. Hasta 10; el orden en que las añades es «imagen uno», «imagen dos».
3. Escribe el cambio en Prompt, indicando qué aporta cada imagen y qué debe conservarse.
4. Elige Output size según la forma de la fuente.
5. Revisa la estimación de precio y ejecuta. La vista JSON muestra el cuerpo de la solicitud, que puedes copiar a tu código.

Después, llámalo desde código

Instala el SDK de Python (pip install spicyapi), define SPICY_API_KEY en el entorno de tu servidor y ejecuta:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

task = client.create_task(
    model="bytedance/seedream-4.0/edit",
    input_data={
        "image_urls": [
            "https://example.com/person.png",
            "https://example.com/blazer.png",
        ],
        "prompt": "Keep the person, pose and scene from image one. Image two defines the burgundy blazer cut, lapels and fabric; use its garment only.",
        "size": "1728*2304",
    },
    idempotency_key=str(uuid.uuid4()),
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
print(output_assets(final)[0]["url"])  # copy it to your own storage now

Sustituye las dos URL de ejemplo por las tuyas; deben ser accesibles sin iniciar sesión, o sube un archivo local y pasa el URI spicy:// devuelto. El enlace del resultado caduca tras unos 20 minutos (detalles de retención). Los presupuestos, las subidas, la espera, los reintentos y los errores están en la referencia del SDK de Python y en la guía de tareas asíncronas.

O deja que lo ejecute un agente

Si quieres que un asistente ejecute las ediciones por ti, dale la CLI, el servidor MCP o la Skill. La CLI y el servidor MCP muestran el precio y te piden confirmación antes de una llamada de pago.

• CLI. Pon el mismo objeto input en input.json y ejecuta lo siguiente (npx @spicyapi/cli funciona sin instalar; consulta la documentación de la CLI):

``bash spicyapi tasks create --model bytedance/seedream-4.0/edit --input-file input.json --wait ``

• Servidor MCP. Añade el servidor MCP a tu asistente y pide: «Edita ./portrait.png con Seedream 4.0: sustituye solo la chaqueta por un blazer de terciopelo burdeos, tamaño 1728*2304.» Llama a spicyapi_upload_file, luego a spicyapi_task_create, que se detiene para que confirmes el precio, y después a spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill instala la Agent Skill, con la que un asistente de programación lee el esquema vivo del modelo en lugar de adivinar los campos.

Convierte un boceto en un concepto de materiales

Pon primero el boceto y después una muestra de material, e indica qué corresponde a cada uno. Un ejemplo con un reloj ficticio:

Convierte el boceto del reloj de la imagen uno en un concepto de producto realista. Conserva su caja arqueada continua, la esfera circular crema centrada y los dos pies cortos. Usa la imagen dos solo para el color y la veta del nogal. Da a los pies un acabado de latón mate y a la esfera dos manecillas negras sencillas. Vista frontal sobre una superficie de piedra clara, luz lateral suave, sin marcas ni objetos adicionales.

La misma división sirve para un vestuario: el dibujo fija la silueta, una imagen de tela la superficie y un retrato aprobado a la persona ficticia que lo lleva. Usa un boceto limpio, sin trazos abandonados. Un boceto solo frontal no puede definir una vista lateral, así que pide primero un resultado frontal si el contorno importa.

Soluciona fallos concretos

El nuevo atuendo cambió el rostro. Vuelve al retrato original, quita a otras personas de la referencia de la prenda y mantén la vista original. Si el rostro debe quedar exacto al píxel, compón el rostro aprobado de forma convencional en lugar de pedir otro redibujado completo.

El material se extendió a otros objetos. Nombra la superficie: el terciopelo es solo del blazer, la camisa sigue siendo de algodón crema; el nogal es de la caja del reloj, no de la esfera ni de los pies de latón. Una muestra estrecha es más clara que una habitación entera usada como imagen de «estilo».

La silueta del boceto cambió. Simplifica el boceto y pide una vista frontal. Un ángulo dramático puede ocultar el contorno que querías conservar.

El sujeto queda recortado. Elige un preajuste que coincida con la forma y pide espacio alrededor de la cabeza, los pies o el objeto de escena.

Un logotipo pequeño o una frase está mal. Conserva la escena y sustituye ese elemento en un editor convencional. Sin máscara, corregir un texto es un nuevo redibujado, no un parche local.

Las ediciones repetidas se desvían. Cada pasada redibuja el encuadre. Para cambios acumulativos, usa el último resultado aceptado y comprueba qué se movió; si vuelves al original, incluye en el prompt todos los cambios aceptados. Inicia las variaciones independientes desde un original común.

Coste y cuándo elegir otro modelo

Tres ediciones cuestan 0,09 $ y diez cuestan 0,30 $. Los tamaños mayores y las referencias adicionales no suman nada. Para una imagen nueva sin fuente, usa Seedream 4.0 de texto a imagen, que tiene los mismos tamaños y el mismo precio.

Elige 4.0 para encuadres grandes de hasta 4096*2304 a tarifa fija. Elige un modelo 5.0 cuando necesites un aspect_ratio como 4:5, salida PNG (todos los modelos 5.0) o fondos transparentes (Flash y Pro). Elige otro método cuando necesites una máscara, píxeles conservados o geometría de ingeniería exacta. Para creatividades publicitarias a partir de fotos de producto, consulta de la foto de producto a la creatividad publicitaria.