DOCUMENTATION API

API REST pour un accès programmatique à tous les services LoadSh.it

v1.0

Introduction

L'API LoadSh.it permet un accès programmatique à toutes les fonctionnalités principales : conversion de fichiers, scans de sécurité et transcription audio/vidéo.

80+ Formats

Vidéo, Audio, Images, Documents

Scan ClamAV

Antivirus Entreprise

Whisper AI

Transcription en 99 langues

Authentification

Toutes les requêtes API nécessitent une clé API valide dans l'en-tête Authorization Header. Les clés API peuvent être créées dans les Paramètres .

EN-TÊTE HTTP

Authorization: Bearer lsh_live_xxxxxxxxxxxxxxxxxxxxxxxx

Important : Conservez votre clé API en sécurité. Elle n'est affichée qu'une seule fois lors de la création et ne peut pas être récupérée.

URL de base

https://loadsh.it/api

Tous les endpoints sont relatifs à cette URL de base.

Limites de débit

L'API n'a actuellement pas de limites de débit strictes pour les utilisateurs authentifiés. Nous nous réservons le droit d'introduire des limites en cas d'abus.

Requêtes/Min	Taille max. fichier
Illimité	5 GB

Endpoints

POST /api/convert

Convertir un fichier

Convertit un fichier vers un autre format. Prend en charge vidéo, audio, images et documents.

Paramètres

Nom	Type	Description
`file` required	File	Le fichier à convertir (multipart/form-data)
`target_format` required	string	Format cible (ex. : "mp4", "pdf", "png")
`processing_mode`	string	"auto" \| "force_cpu" \| "force_gpu"

Exemples

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();

Réponse

JSON

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

POST /api/scan

Scan de sécurité

Analyse un fichier pour détecter virus, malware et autres menaces avec ClamAV & YARA Rules.

Paramètres

Nom	Type	Description
`file` required	File	Le fichier à analyser (multipart/form-data)

Exemples

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();

Réponse

JSON

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

POST /api/transcript

Transcription Audio/Vidéo

Extrait le texte des fichiers audio et vidéo avec Whisper AI.

Paramètres

Nom	Type	Description
`file` required	File	Fichier Audio/Vidéo (multipart/form-data)
`language`	string	Langue (ex. : "fr", "en"). Détection auto si vide.

Exemples

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();

Réponse

JSON

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

GET /api/status/:jobId

Obtenir le statut du job

Vérifie le statut actuel d'un job en cours ou terminé.

Paramètres

Nom	Type	Description
`jobId` required	string	L'ID du job de la requête originale

Exemples

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();

Réponse

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

Lister les clés API

Liste toutes les clés API de l'utilisateur authentifié.

Exemples

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();

Réponse

JSON

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

POST /api/user/api-keys

Créer une clé API

Crée une nouvelle clé API. La clé complète n'est affichée qu'une seule fois !

Paramètres

Nom	Type	Description
`name` required	string	Nom/description de la clé

Exemples

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();

Réponse

JSON

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

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

Supprimer une clé API

Supprime définitivement une clé API.

Paramètres

Nom	Type	Description
`id` required	string	ID de la clé à supprimer

Exemples

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();

Réponse

JSON

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

Codes d'erreur

Code	Signification
400	Requête invalide (paramètres manquants)
401	Non authentifié (clé API invalide)
403	Accès refusé (limite atteinte)
404	Job ou ressource non trouvé
413	Fichier trop volumineux
429	Trop de requêtes
500	Erreur serveur