Unir imágenes
Unir imágenes es una herramienta documentada de la API gratuita de APIAny: pruébela en el navegador y luego llame la misma operación con una clave API.
Une hasta 20 imágenes en horizontal o vertical con separación.
POST /api/free/join-imagesFuentes
¿Qué referencias oficiales cita esta página?
Las citas siguientes proceden de la documentación oficial de API que APIAny implementa.
The Fetch API provides an interface for fetching resources (including across the network).
The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP and AVIF images of varying dimensions.
The Images API provides several endpoints that let you generate images from text prompts or create edits of existing images.
Usar 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.