Recortar imagen
Recorta una región rectangular precisa mediante coordenadas.
POST /api/free/crop-imageUsar Recortar imagen 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
Opción por lotes de pago
Abre la página por lotes de pago para aplicar la misma operación a varios archivos.
Integrar mediante API
Solo las llamadas programáticas requieren una clave API. Abajo se documentan parámetros, respuestas y errores.
POST /api/free/crop-imageEl uso en línea no requiere clave; las llamadas programáticas necesitan una clave de APIAny.
- Las coordenadas parten de la esquina superior izquierda.
- El rectángulo debe permanecer dentro de la imagen.
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 |
|---|---|---|---|
imageArchivo de imagen | Obligatorio | — | file |
leftDesplazamiento izquierdo | Obligatorio | 0 | number |
topDesplazamiento superior | Obligatorio | 0 | number |
widthAncho de recorte | Obligatorio | 500 | number |
heightAlto de recorte | Obligatorio | 500 | number |
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/crop-image" \ -H "Authorization: Bearer $API_KEY" \ -F "image=@input.jpg" \ -F "left=0" \ -F "top=0" \ -F "width=500" \ -F "height=500" \ --output cropped.webp
Preguntas frecuentes
¿Necesito una clave para Recortar imagen?
No en el Playground. Las llamadas programáticas usan Authorization: Bearer o X-API-Key.
¿Qué límites tiene Recortar imagen?
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 Recortar imagen?
Usa los campos obligatorios y opcionales de la tabla. Los formatos no admitidos y valores fuera de rango se rechazan.
¿Qué devuelve Recortar imagen?
Las solicitudes correctas devuelven una respuesta image; los errores usan los códigos HTTP indicados.