Referencia de la API

Cada endpoint, cada parámetro, cada campo de respuesta. URL base: https://cleverutils.com/api/v1

Convertidor universal

POST/api/v1/convert

Convierte un único archivo a un formato de destino. Utilizado por más de 143 pares de formatos (imagen, audio, vídeo, documento, archivo comprimido, 3D, fuente).

Request (multipart/form-data)

CampoTipoNotas
file OBLIGATORIOarchivoEl archivo de origen. Hasta 200 MB.
to_format OBLIGATORIOcadenaExtensión del formato de destino, por ejemplo png, mp3, pdf, webp. 2–5 caracteres alfanuméricos.
img_quality opcionalenteroCalidad de imagen 0–100. Por defecto 80. Se usa para compresión JPG, WebP, PDF.
img_resize_w, img_resize_h opcionalenteroRedimensionar a dimensiones exactas (16–7680 px). Use una o ambas.
img_rotate opcionalcadenaRotar: 90, 180, 270, flip-h, flip-v.
img_crop_x, img_crop_y, img_crop_w, img_crop_h opcionalenteroRegión de recorte en píxeles.
mp3_mode, mp3_quality, mp3_bitrate opcionalvariosOpciones del codificador MP3. Consulte la referencia de audio.
wav_rate, wav_depth, wav_channels opcionalenteroOpciones de salida WAV.
ocr_lang opcionalcadenaIdioma Tesseract para OCR de PDF/imagen. Por defecto eng.

Response (éxito, 200)

JSON
{ "data": {
    "job_id": "5f8c1a2e9d4b7c0e3f6a8b2d1e4c5f78",
    "status": "done",
    "output": { "filename": "photo_cleverutils.com.jpg", "size_bytes": 184523, "size_human": "180 KB", "url": "https://cleverutils.com/api/v1/jobs/5f8c.../output" },
    "links": { "self": "...", "output": "..." },
    "expires_at": "2026-04-10T14:32:11Z"
} }

Procesamiento por batch

POST/api/v1/batch

Convierte hasta 20 archivos en una sola request. Cada archivo cuenta individualmente en su cuota diaria.

CampoTipoNotas
files[] OBLIGATORIOarchivo[]Hasta 20 archivos en una sola request multipart.
to_format OBLIGATORIOcadenaFormato de destino aplicado a todos los archivos.

Estructura de la response

Devuelve un batch_id más un array de jobs por archivo. Use GET /api/v1/batches/{batch_id} para consultar el estado agregado después.

Ciclo de vida del job

GET/api/v1/jobs/{job_id}

Consulta el estado de un job de conversión. job_id tiene 32 caracteres hexadecimales devueltos por /api/v1/convert.

Estados de la response

  • data.status: "processing" — conversión en curso, progress opcional 0–99
  • data.status: "done" — conversión completada, bloque output relleno
  • HTTP 404 con error.code: JOB_NOT_FOUND — ID incorrecto o caducado
  • HTTP 500 con error.code: CONVERSION_FAILED — conversión fallida
GET/api/v1/jobs/{job_id}/output

Transmite el archivo convertido como adjunto binario. Devuelve Content-Type coincidente con el MIME de salida y Content-Disposition: attachment; filename=.... Los archivos caducan 2 horas tras la conversión.

GET/api/v1/batches/{batch_id}

Estado agregado de todos los jobs de un batch. Formato de batch_id: bat_ seguido de 16 caracteres hexadecimales. Incluye overall_status (done / processing / failed) más el array por job.

Herramientas de IA

POST/api/v1/tools/{slug}

Herramientas especializadas que no encajan en una simple conversión de formato. Cada herramienta tiene su propio conjunto de parámetros.

SlugDescripciónLímite diario
upscale-imageEscalado IA 2x/3x/4x (Real-ESRGAN). Opcional: scale, model.50
enhance-photoMejora automática de foto (actualmente alias de colorize).50
vocal-removerSeparar voz de instrumental (Demucs).50
speech-to-textTranscribir audio/vídeo. Opciones: format (txt/srt/vtt), quality, language.100
remove-backgroundEliminar fondo de imagen (rembg).100
colorize-photoColorear fotos en blanco y negro (siggraph17).50
restore-old-photoRestaurar y colorear fotos antiguas.50
noise-reductionReducción de ruido de audio (DeepFilterNet3).50
change-backgroundReemplazar fondo de imagen.100
remove-objectEliminar objeto mediante inpainting (LaMa).50
passport-photoGenerar foto de pasaporte.100
image-to-textOCR (Tesseract). Devuelve text en JSON, sin download_url.100

Herramientas de edición de imagen

POST/api/v1/tools/{slug}
SlugDescripción
resize-imageRedimensionar. Pase img_resize_w y/o img_resize_h.
compress-image, compress-jpg, compress-png, compress-webp, compress-gifComprimir con img_quality.
crop-imageRecortar región con img_crop_x/y/w/h.
rotate-imageRotar con img_rotate.
grayscale-imageConvertir a escala de grises.
blur-imageAplicar desenfoque gaussiano.
watermark-imageAñadir marca de agua de texto.
og-image-resizerRedimensionar a dimensiones OG estándar (1200x630).

Herramientas de edición de audio y vídeo

POST/api/v1/tools/{slug}
SlugDescripción
audio-cutterRecortar audio. Pase start_time, end_time.
trim-videoRecortar vídeo a un rango de tiempo.
compress-videoComprimir con bitrate objetivo o preset de calidad.
extract-audio-from-videoExtraer pista de audio como MP3.
remove-audio-from-videoEliminar audio del vídeo.
merge-videosFusionar varios archivos de vídeo. Envíe files[].
reverse-videoReproducir vídeo al revés.
gif-makerCrear GIF animado desde cuadros o vídeo.

Herramientas PDF

POST/api/v1/tools/{slug}
SlugDescripción
compress-pdfComprimir con calidad 0–100 (mapeada a Ghostscript /screen, /ebook, /printer, /prepress).
merge-pdfFusionar varios PDF. Envíe files[].
split-pdfDividir PDF en páginas individuales.
pdf-page-removerEliminar páginas específicas. Pase pages como lista separada por comas.
protect-pdfAñadir contraseña. Pase password.
unlock-pdfEliminar contraseña. Pase password.
webpage-to-pdfConvertir URL a PDF. Pase url en lugar de file.

Salud y límites

GET/api/v1/health

Sonda de vivacidad. Devuelve el estado del servicio y las versiones detectadas de los binarios (ImageMagick, FFmpeg, Ghostscript, LibreOffice, Tesseract). NO cuenta contra los límites de tasa.

GET/api/v1/limits

Inspección de solo lectura de su uso actual del rate-limit. Devuelve contadores diarios y por hora, cuotas restantes y estado de baneo. NO cuenta contra los límites de tasa.

Véase también

Solicitar una función

0 / 2000