DOCUMENTACIÓN API

API REST para acceso programático a todos los servicios de LoadSh.it

v1.0

Introducción

La API de LoadSh.it proporciona acceso programático a todas las funciones principales: conversión de archivos, escaneos de seguridad y transcripción de audio/video.

80+ Formatos

Video, Audio, Imágenes, Documentos

Escaneo ClamAV

Antivirus Empresarial

Whisper AI

Transcripción en 99 idiomas

Autenticación

Todas las solicitudes API requieren una clave API válida en el encabezado Authorization Header. Las claves API se pueden crear en la Configuración .

ENCABEZADO HTTP

Authorization: Bearer lsh_live_xxxxxxxxxxxxxxxxxxxxxxxx

Importante: Guarda tu clave API de forma segura. Solo se muestra una vez al crearla y no se puede recuperar.

URL Base

https://loadsh.it/api

Todos los endpoints son relativos a esta URL base.

Límites de velocidad

La API actualmente no tiene límites de velocidad estrictos para usuarios autenticados. Nos reservamos el derecho de introducir límites en caso de abuso.

Solicitudes/Min	Tamaño máx. archivo
Ilimitado	5 GB

Endpoints

POST /api/convert

Convertir archivo

Convierte un archivo a otro formato. Soporta video, audio, imágenes y documentos.

Parámetros

Nombre	Tipo	Descripción
`file` required	File	El archivo a convertir (multipart/form-data)
`target_format` required	string	Formato destino (ej. "mp4", "pdf", "png")
`processing_mode`	string	"auto" \| "force_cpu" \| "force_gpu"

Ejemplos

cURL

BASH

curl -X POST "https://loadsh.it/api/convert" \
  -H "Authorization: Bearer lsh_live_xxxx" \
  -F "[email protected]" \
  -F "target_format=mp4"

JavaScript

JAVASCRIPT

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('target_format', 'mp4');

const response = await fetch(
  'https://loadsh.it/api/convert',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' },
    body: formData
  }
);
const data = await response.json();

Respuesta

JSON

{
  "success": true,
  "job_id": "conv_abc123",
  "status": "processing"
}

POST /api/scan

Escaneo de seguridad

Escanea un archivo en busca de virus, malware y otras amenazas con ClamAV & YARA Rules.

Parámetros

Nombre	Tipo	Descripción
`file` required	File	El archivo a escanear (multipart/form-data)

Ejemplos

cURL

BASH

curl -X POST "https://loadsh.it/api/scan" \
  -H "Authorization: Bearer lsh_live_xxxx" \
  -F "[email protected]"

JavaScript

JAVASCRIPT

const formData = new FormData();
formData.append('file', fileInput.files[0]);

const response = await fetch(
  'https://loadsh.it/api/scan',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' },
    body: formData
  }
);
const data = await response.json();

Respuesta

JSON

{
  "success": true,
  "job_id": "scan_xyz789",
  "status": "processing"
}

POST /api/transcript

Transcripción Audio/Video

Extrae texto de archivos de audio y video usando Whisper AI.

Parámetros

Nombre	Tipo	Descripción
`file` required	File	Archivo Audio/Video (multipart/form-data)
`language`	string	Idioma (ej. "es", "en"). Detección auto si está vacío.

Ejemplos

cURL

BASH

curl -X POST "https://loadsh.it/api/transcript" \
  -H "Authorization: Bearer lsh_live_xxxx" \
  -F "[email protected]" \
  -F "language=de"

JavaScript

JAVASCRIPT

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('language', 'de');

const response = await fetch(
  'https://loadsh.it/api/transcript',
  {
    method: 'POST',
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' },
    body: formData
  }
);
const data = await response.json();

Respuesta

JSON

{
  "success": true,
  "job_id": "trans_def456",
  "status": "processing"
}

GET /api/status/:jobId

Obtener estado del trabajo

Comprueba el estado actual de un trabajo en curso o completado.

Parámetros

Nombre	Tipo	Descripción
`jobId` required	string	El ID del trabajo de la solicitud original

Ejemplos

cURL

BASH

curl -X GET "https://loadsh.it/api/status/conv_abc123" \
  -H "Authorization: Bearer lsh_live_xxxx"

JavaScript

JAVASCRIPT

const response = await fetch(
  'https://loadsh.it/api/status/conv_abc123',
  {
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' }
  }
);
const data = await response.json();

Respuesta

JSON

{
  "success": true,
  "status": "completed",
  "progress": 100,
  "result": {
    "download_url": "https://loadsh.it/dl/...",
    "expires_at": "2026-02-04T12:00:00Z"
  }
}

GET /api/user/api-keys

Listar claves API

Lista todas las claves API del usuario autenticado.

Ejemplos

cURL

BASH

curl -X GET "https://loadsh.it/api/user/api-keys" \
  -H "Authorization: Bearer lsh_live_xxxx"

JavaScript

JAVASCRIPT

const response = await fetch(
  'https://loadsh.it/api/user/api-keys',
  {
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' }
  }
);
const data = await response.json();

Respuesta

JSON

{
  "success": true,
  "keys": [
    {
      "id": "key_123",
      "name": "Production",
      "created_at": "2025-01-01",
      "last_used": "2025-01-03"
    }
  ]
}

POST /api/user/api-keys

Crear clave API

Crea una nueva clave API. ¡La clave completa solo se muestra una vez!

Parámetros

Nombre	Tipo	Descripción
`name` required	string	Nombre/descripción de la clave

Ejemplos

cURL

BASH

curl -X POST "https://loadsh.it/api/user/api-keys" \
  -H "Authorization: Bearer lsh_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "My App"}'

JavaScript

JAVASCRIPT

const response = await fetch(
  'https://loadsh.it/api/user/api-keys',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer lsh_live_xxxx',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ name: 'My App' })
  }
);
const data = await response.json();

Respuesta

JSON

{
  "success": true,
  "key": {
    "id": "key_456",
    "name": "My App",
    "token": "lsh_live_xxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

DELETE /api/user/api-keys/:id

Eliminar clave API

Elimina permanentemente una clave API.

Parámetros

Nombre	Tipo	Descripción
`id` required	string	ID de la clave a eliminar

Ejemplos

cURL

BASH

curl -X DELETE "https://loadsh.it/api/user/api-keys/key_123" \
  -H "Authorization: Bearer lsh_live_xxxx"

JavaScript

JAVASCRIPT

const response = await fetch(
  'https://loadsh.it/api/user/api-keys/key_123',
  {
    method: 'DELETE',
    headers: { 'Authorization': 'Bearer lsh_live_xxxx' }
  }
);
const data = await response.json();

Respuesta

JSON

{
  "success": true,
  "message": "Key deleted"
}

Códigos de error

Código	Significado
400	Solicitud inválida (faltan parámetros)
401	No autenticado (clave API inválida)
403	Acceso denegado (límite alcanzado)
404	Trabajo o recurso no encontrado
413	Archivo demasiado grande
429	Demasiadas solicitudes
500	Error del servidor