Introducción
Image Expander hace crecer una foto hacia afuera hasta darle una forma nueva. Eliges una relación de aspecto de destino y la herramienta conserva tu imagen, la coloca dentro de un marco más ancho o más alto y pinta escenario nuevo en el espacio vacío, de modo que el resultado se lee como una sola imagen continua. Es lo contrario de recortar: no se corta nada del original y nada se estira para llenar el marco.
Funciones y aspectos destacados
Siete formas de destino
La imagen final puede ser cuadrada, horizontal o vertical: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 o 2:3. Con eso cubres publicaciones, portadas de video, historias, banners y diseños de estilo impreso a partir de una sola foto, sin planear cada recorte durante la sesión.
Continuación en lugar de relleno
La zona nueva se pinta para continuar lo que ya existe. Pisos, cielos, paredes, follaje y la dirección de la luz siguen más allá del borde anterior, en lugar de que el marco se rellene con desenfoque, bordes en espejo o un color sólido.
Ningún prompt que escribir
La extensión se deduce de la propia imagen. Una imagen y una proporción son toda la solicitud, así que es sencillo convertir una carpeta de fotos verticales en banners horizontales en un solo lote.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La foto que quieres ampliar, en JPEG, PNG o WebP. Se coloca dentro del marco más grande y se pinta el entorno alrededor. mínimo 1 caracteres |
aspect_ratio | No | Forma de la imagen final. El lado largo siempre mide 1536 píxeles: 16:9 da 1536 × 864, 9:16 da 864 × 1536 y 1:1 da 1536 × 1536. |
output_format | No | PNG por defecto; JPEG o WebP para archivos más ligeros. |
Precios
$0.024 / imagen
Se cobra por imagen generada; la relación de aspecto que eliges no cambia el precio.
Casos de uso
Una sesión, todos los formatos
Convierte una foto vertical de producto o un retrato en un encabezado web 16:9 y en un mosaico 1:1 para marketplace, sin volver a fotografiar y sin franjas incómodas a los lados del encuadre.
Espacio para texto y diseño
Agrega cielo o fondo alrededor de un sujeto para dejar espacio limpio para un titular, un logo o una llamada a la acción en un banner, una miniatura o una diapositiva de presentación.
Corregir encuadres apretados
Devuelve aire a las fotos encuadradas demasiado cerca: un codo cortado, una silla recortada por el borde, un horizonte pegado al marco.
Guía de prompts y consejos prácticos
Elige la proporción según el destino
Decide dónde se usará la imagen antes de ampliarla: 16:9 para portadas de video y encabezados, 9:16 para historias y reels, 1:1 para feeds y marketplaces, 3:2 o 2:3 para diseños de estilo impreso. Cuanto más se aleja la forma nueva del original, más escenario hay que inventar, así que los cambios moderados se integran mejor.
Ten en cuenta el tamaño de salida
La imagen ampliada mide 1536 píxeles en su lado largo. Un original grande vuelve, por lo tanto, más pequeño de lo que entró; si el destino necesita más píxeles, escala el resultado después en lugar de partir de una fuente de menor calidad.
Empieza con bordes limpios
La herramienta continúa todo lo que toca el borde de la foto. Los fondos sencillos, como el cielo, el papel de estudio, las paredes lisas o la arena, se extienden de forma más convincente. Cuando una cara, una mano o un texto queda cortado por el borde, la herramienta tiene que inventar la parte que falta, y ahí es donde los resultados son menos predecibles, así que elige una fuente con más margen alrededor de esos detalles.
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": "spicyapi/image-expander-v1/edit",
"input": {
"aspect_ratio": "1:1",
"image_url": "https://example.com/reference.png",
"output_format": "png"
}
}'
# 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.
