Genera imágenes dinámicas con solo una URL

API simple y veloz para crear placeholders personalizables en múltiples formatos (SVG, PNG, JPEG, WEBP) con tamaño, colores, formas y texto configurables.

🎮 Pruebalo ahora

Experimenta con todos los parámetros y ve los resultados al instante

⚙️ Configuración

×
💡 Vacío = color aleatorio
💡 Vacío = color aleatorio
0px
/image?size=400x300&text=¡Hola+Mundo!&format=svg

👁️ Vista Previa

Preview
400 × 300 SVG

🔗 Endpoint Principal

¡Súper simple! Puedes usar solo /image y obtener una imagen aleatoria al instante

✨ Uso más simple

GET /image

¡Eso es todo! Obtienes una imagen placeholder aleatoria instantáneamente.

📝 Ejemplos de uso

🎲 Aleatorio
/image
Aleatorio

Imagen con tamaño y colores aleatorios

📐 Con tamaño
/image?size=300x200
Con tamaño

Especifica ancho y alto exactos

📱 Aspect Ratio 16:9
/image?ar=16-9&size=320&text=Widescreen
Aspect ratio 16:9

Mantiene proporción exacta

⭕ Círculo
/image?size=200x300&circle=true&text=Avatar
Círculo

Fuerza forma circular

🎨 Personalizado
/image?size=280x180&background=667eea&color=ffffff&radius=16&text=Moderno
Personalizado

Con texto y colores específicos

📱 Móvil (9:16)
/image?ar=9-16&size=180&text=Mobile&format=webp
Móvil

Formato vertical móvil

📝 Texto multilínea
/image?size=300x200&text=Línea+1\nLínea+2\nLínea+3
Multilínea

Soporte para múltiples líneas

🎯 Square
/image?size=400x600&square=true&text=Cuadrado
Square

Fuerza imagen cuadrada

⚙️ Parámetros Disponibles

Personaliza completamente tus imágenes con estos parámetros

sizestring
Dimensiones en formato ANCHOxALTO. Si se omite, genera tamaño aleatorio entre 200-2000px.
size=600x400
arstring
Aspect ratio en formato W-H. Prioriza ancho como base, calcula altura. Si altura > 2000px, recalcula.
ar=16-9
formatstring
Formato de salida: svg (default), png, jpeg, jpg, webp.
format=png
textstring
Texto a mostrar (máx. 200 chars). Soporta \n para saltos de línea. Default: dimensiones.
text=Mi+Placeholder
backgroundhex
Color de fondo en formato hex (sin #). Default: gris oscuro aleatorio.
background=2d3748
colorhex
Color del texto en formato hex (sin #). Default: gris claro aleatorio.
color=ffffff
radiusnumber
Redondeo de esquinas en píxeles. Default: 0.
radius=12
squareboolean
Fuerza imagen cuadrada usando primer valor de size. Si no hay size, genera lado aleatorio.
square=true
circleboolean
Fuerza imagen cuadrada y la renderiza como círculo (radio = mitad del lado).
circle=true

📋 Códigos de Respuesta

Qué esperar de la API

✅ 200 OK
Imagen generada exitosamente con el Content-Type correspondiente.
⚠️ 400 Bad Request
Formato no soportado. Mensaje: "Unsupported format."
❌ 500 Internal Server Error
Error al generar imagen. Mensaje: "Error generating image"