Introducción
La edición de imágenes de Seedream 5.5 parte de imágenes existentes y usa una instrucción escrita para modificarlas o combinarlas. Esta API de edición de imágenes por IA acepta de una a diez referencias. Identifica las imágenes por número, describe el nuevo resultado e indica qué detalles deben conservarse.
Los ejemplos de esta página muestran dos encargos distintos. Uno reúne retratos separados en una escena en una azotea iluminada con velas. Otro cambia el vestuario y traslada un retrato a una calle de Tokio bajo la lluvia al anochecer. Nuestras pruebas mantuvieron reconocibles a ambas personas en la composición de la azotea. Otra prueba de persona y taza conservó el logotipo del producto.
Funciones y aspectos destacados
Fuentes numeradas con funciones definidas
Usa Image 1, Image 2 y los números siguientes para identificar las fuentes en la instrucción. Una referencia puede aportar una persona o un objeto mientras el texto define el nuevo escenario. Asignar esas funciones aclara la composición solicitada. Por ejemplo: «Usa la persona de Image 1 y la taza de Image 2».
El prompt de la azotea asigna un retrato distinto a cada entrada numerada. Sigue esa estructura para combinar una escena en lugar de describir las fuentes como un grupo sin identificar. Después de los cambios, incluye una instrucción sobre lo que debe conservarse para definir tanto la nueva dirección como los detalles fijos.
Cambios con objetivos de conservación explícitos
ByteDance describe zonas sin editar estables durante más de 100 rondas. Nuestras pruebas cubrieron cambios concretos de vestuario, ubicación y composición con referencias; no comprobaron una secuencia de 100 rondas. Considera por separado la afirmación de ByteDance y los ejemplos medidos.
El ejemplo de Tokio bajo la lluvia pide otro vestido y una nueva calle, conservando la identidad de la persona. El de la azotea conserva a las personas de dos retratos fuente. En una composición de producto, «Conserva el logotipo de la taza» indica un detalle concreto que debe mantenerse.
La forma de salida se decide por separado
La edición no hereda la forma de la imagen fuente. aspect_ratio usa 1:1 por defecto incluso con una entrada vertical u horizontal. Elige una proporción equivalente cuando importe conservar las proporciones originales o selecciona otra admitida para un nuevo destino.
Las formas disponibles son 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 y 21:9. El ejemplo de la calle bajo la lluvia usa 3:4 y el de los dos retratos en la azotea usa 4:3. Mantén coherentes la composición descrita en el prompt y el lienzo seleccionado.
Resolución, formato y fondo
La edición ofrece 1k, 1.5k, 2k y 4k, con 2k por defecto. En 4k, la salida 16:9 mide 3840 x 2160 píxeles y la cuadrada mide 2880 x 2880. PNG es el formato por defecto y también está disponible JPEG. Para obtener un canal alfa, selecciona PNG con background transparent; de lo contrario, background comienza en auto.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Por ahora, esta versión está moderada; pronto habrá una versión sin moderación. Algunas solicitudes se rechazan sin cargo. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | Proporciona de 1 a 10 imágenes de referencia; se requiere una imagen fuente y no hay ninguna seleccionada por defecto. mínimo 1 elementos · máximo 10 elementos |
aspect_ratio | No | Define el lienzo de salida: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 o 21:9. El valor por defecto es 1:1. |
resolution | No | Define el nivel de resolución que se cobra: 1k, 1.5k, 2k o 4k; 2k es el valor por defecto. El nivel cambia el cobro, con la misma tarifa para 1k y 1.5k. |
output_format | No | Elige la codificación png o jpeg; png es el valor por defecto. La codificación no modifica el cobro. |
background | No | Controla el fondo: auto, transparent u opaque; auto es el valor por defecto. Elige transparent junto con png para obtener un canal alfa. |
Precios
La edición se cobra según el nivel de resolución elegido y cada imagen de entrada añade un pequeño cargo, incluida la primera. Los niveles 1k y 1.5k comparten tarifa. La relación de aspecto del lienzo, la codificación y el fondo no añaden cargos.
| Especificación | Precio |
|---|---|
| $0.0195 / imagen |
| $0.0195 / imagen |
| $0.027 / imagen |
| $0.0525 / imagen |
Casos de uso
Trasladar un retrato a otra ubicación
Describe el nuevo escenario con detalles concretos, como una calle secundaria de Tokio bajo la lluvia, luz del anochecer y letreros luminosos. Identifica el retrato fuente y lo que debe conservarse. Así distingues el cambio de escena de la identidad que quieres mantener. El ejemplo ofrece un patrón práctico para redactar esa instrucción.
Reunir retratos separados en una escena
Asigna el primer retrato a Image 1 y el segundo a Image 2. Describe dónde deben aparecer juntas las personas y cómo se ilumina el lugar. La escena de la azotea usa velas y un ambiente nocturno. Nuestras pruebas conservaron ambas identidades en esa edición y aportan un ejemplo medido de este flujo con referencias.
Combinar una persona y una referencia de producto
Asigna al producto su propio número para mencionarlo directamente en la instrucción. Indica qué objeto usar y qué detalles conservar. Nuestra composición de persona y taza mantuvo intacto el logotipo. Usa una frase como «Conserva el logotipo de Image 2» para expresar ese requisito de forma explícita.
Cambiar el vestuario conservando la identidad
Indica el cambio de vestuario y a quién se aplica. Añade el lugar y la luz si también deben cambiar. Después expresa por separado qué debe conservarse, por ejemplo: «Mantén a la misma persona de Image 1». El prompt de la calle bajo la lluvia demuestra este patrón con un vestido rojo y una nueva ubicación.
Guía de prompts y consejos prácticos
Asigna las entradas antes de describir el resultado
Incluye una lista breve de fuentes: «Image 1 aporta la persona; Image 2 aporta la taza». Comprueba que los números coincidan con el orden de las entradas. Si incluyes más referencias, explica qué aporta cada una para que su propósito quede claro.
Separa los cambios de los detalles fijos
Usa frases directas como «Traslada la escena a una azotea iluminada con velas» y después «Conserva a las personas». Para un producto, especifica «Conserva el logotipo del zorro blanco en la taza». Así conservar un detalle se vuelve un requisito concreto. Compara esos detalles con las fuentes cuando recibas la edición.
Elige la proporción de forma explícita
Si necesitas las proporciones de la fuente, selecciona el aspect_ratio admitido que corresponda antes de enviar. Una fuente vertical puede usar 3:4 si coincide con el encuadre buscado. El valor por defecto produce un lienzo cuadrado; colocar una referencia primero no convierte su forma en el ajuste de salida.
Usa zonas marcadas para una instrucción local
El prompt puede referirse a cuadros, flechas o coordenadas marcados en una imagen de entrada. Menciona juntos el número de referencia y la zona marcada, por ejemplo: «Cambia el objeto dentro del cuadro marcado en Image 1». Después describe el reemplazo y los detalles del entorno que deben conservarse. Así la instrucción tiene un objetivo visible.
Vincula el texto exacto con su objeto
Cuando una referencia incluya un logotipo o texto impreso importante, identifícalo como algo que debe conservarse. Para texto nuevo proporcionado, escribe el contenido entre comillas e indica que no deben aparecer palabras adicionales. Esta indicación viene de nuestras observaciones de generación de texto y también delimita el contenido escrito de una edición.
Selecciona la transparencia en los controles de salida
Un resultado transparente requiere codificación png y background transparent. JPEG no conserva la transparencia aunque el prompt describa un objeto aislado. Si la edición debe ser una escena completa, selecciona el modo de fondo adecuado después de revisar los ajustes de recorte.
Conserva un registro útil de la edición
El prompt de edición admite hasta 5000 caracteres; ByteDance recomienda no superar las 600 palabras en inglés. Centra la instrucción en las funciones de las fuentes, los cambios solicitados y los detalles que deben conservarse. Guarda juntas las entradas, la instrucción, los ajustes de salida y el resultado descargado para partir de un registro claro del diseño en una revisión posterior.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.5/edit",
"input": {
"aspect_ratio": "1:1",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
