Unir imágenes
Une hasta 20 imágenes en horizontal o vertical con separación.
POST /api/free/join-imagesUsar Unir imágenes en línea
Sube, configura, previsualiza y descarga sin clave API.
1. Subida y ajustes
Úsalo sin clave. Los archivos solo se envían al ejecutar la solicitud.
2. Vista previa y descarga
Aquí se muestran la vista previa, los cambios de tamaño y la descarga
Integrar mediante API
Solo las llamadas programáticas requieren una clave API. Abajo se documentan parámetros, respuestas y errores.
POST /api/free/join-imagesEl uso en línea no requiere clave; las llamadas programáticas necesitan una clave de APIAny.
- Las imágenes se alinean sin ampliarse.
- El lienzo está limitado a 8192 píxeles por lado.
Respuesta
Una solicitud correcta devuelve una respuesta image con el Content-Type descrito.
Errores comunes
- 400
- Falta un archivo o parámetro, no es válido o supera un límite.
- 401
- Falta la clave para la llamada programática, es inválida o está desactivada.
- 429
- Se alcanzó el límite compartido en línea o autenticado.
Parámetros y límites
| Parámetro | Requisito | Predeterminado | Valores aceptados |
|---|---|---|---|
filesArchivos de imagen | Obligatorio | — | file |
directionDirección | Opcional | horizontal | horizontal, vertical |
gapSeparación | Opcional | 0 | number |
backgroundColor de fondo | Opcional | #ffffff | text |
formatFormato de salida | Opcional | webp | webp, png, jpeg |
Ejemplo de API
Este ejemplo autenticado es para código. El Playground no solicita ni expone tu clave.
curl -X POST "https://apiany.ai/api/free/join-images" \ -H "Authorization: Bearer $API_KEY" \ -F "files=@a.png" \ -F "files=@b.png" \ -F "direction=horizontal" \ --output joined.webp
Preguntas frecuentes
¿Necesito una clave para Unir imágenes?
No en el Playground. Las llamadas programáticas usan Authorization: Bearer o X-API-Key.
¿Qué límites tiene Unir imágenes?
En línea: 3 solicitudes por minuto y 30 al día. Las cuentas gratuitas autenticadas tienen 5 RPM y las de pago 500 RPM entre todas las API gratuitas.
¿Qué entradas acepta Unir imágenes?
Usa los campos obligatorios y opcionales de la tabla. Los formatos no admitidos y valores fuera de rango se rechazan.
¿Qué devuelve Unir imágenes?
Las solicitudes correctas devuelven una respuesta image; los errores usan los códigos HTTP indicados.