Transloadit
Tarifs
  • TĂ©lĂ©versements de fichiers
  • Importation de fichiers
  • Traitement par lots
  • Encodage vidĂ©o
  • Encodage audio
  • Traitement d’images
  • Traitement de documents
  • Intelligence artificielle
  • Filtrage et sĂ©curitĂ© des fichiers
  • Catalogage de mĂ©dias
  • Compression de fichiers
  • Évaluation de code
  • Exportation de fichiers
  • Smart CDN
  • Voir tous les services
  • Explorer les intĂ©grations
  • Explorer les dĂ©mos interactives (English)
  • Uppy
  • TransloaditKit
  • SDK Android
  • SDK Node.js
  • Viewer pour Next.js
  • SDK Python
  • SDK Ruby
  • SDK Go
  • SDK Java
  • SDK PHP
  • Zapier
  • Serveur MCP
  • Transloadit CLI
  • Terraform
  • Essentiels
  • Bonnes pratiques
  • FAQ
  • Robots
  • API
  • Formats
  • CrĂ©er votre premiĂšre application
  • À propos de Transloadit
  • Comparatifs
  • Projets open source
  • TĂ©moignages
  • CarriĂšres (English)
  • SĂ©curitĂ©
  • Articles
  • Actus dev (English)
  • Astuces dev
  • Presse
  • Recherche (English)
  • Études de cas
  • Solutions
  • Guides
  • Glossaire
  • Juridique (English)
  • Outils
  • Aider Coursera Ă  former des millions de personnes dans le monde
  • Support Transloadit
  • Support open source
  • Accord de niveau de service (English)
  • RĂ©server une dĂ©mo avec nos ingĂ©nieurs (English)
EssentielsRobotsFAQAPIFormatsBonnes pratiques
Téléversements de fichiers
  • /upload/handle
    Gérer les téléversements
Importation de fichiers
  • /azure/import
    Importer des fichiers depuis Azure
  • /backblaze/import
    Importer des fichiers depuis Backblaze
  • /box/import
    Importer des fichiers depuis Box
  • /mega/import
    Importer des fichiers depuis MEGA S4 Object Storage
  • /cloudfiles/import
    Importer des fichiers depuis Rackspace Cloud Files
  • /cloudflare/import
    Importer des fichiers depuis Cloudflare R2
  • /digitalocean/import
    Importer des fichiers depuis DigitalOcean Spaces
  • /dropbox/import
    Importer des fichiers depuis Dropbox
  • /ftp/import
    Importer des fichiers depuis des serveurs FTP
  • /google/import
    Importer des fichiers depuis Google Cloud Storage
  • /http/import
    Importer des fichiers depuis des serveurs web
  • /minio/import
    Importer des fichiers depuis MinIO
  • /s3/import
    Importer des fichiers depuis Amazon S3
  • /sftp/import
    Importer des fichiers depuis des serveurs SFTP
  • /supabase/import
    Importer des fichiers depuis Supabase Storage
  • /swift/import
    Importer des fichiers depuis OpenStack Swift
  • /tigris/import
    Importer des fichiers depuis Tigris
  • /transloadit/import
    Importer des fichiers depuis Transloadit Storage
  • /vimeo/import
    Importer des vidéos depuis Vimeo
  • /wasabi/import
    Importer des fichiers depuis Wasabi
Encodage vidéo
  • /video/adaptive
    Convertir des vidéos en HLS, MPEG-Dash et CMAF
  • /video/artwork
    Extraire ou insĂ©rer l’illustration de pochette des vidĂ©os
  • /video/concat
    Concaténer des vidéos
  • /video/encode
    Transcoder, redimensionner ou filigraner des vidéos
  • /video/merge
    Fusionner vidéo, audio et images en une seule vidéo
  • /video/ondemand
    Diffuser des vidéos en streaming avec encodage à la demande
  • /video/split
    Découper une vidéo
  • /video/subtitle
    Ajouter des sous-titres aux vidéos
  • /video/thumbs
    Extraire des vignettes de vidéos
  • PrĂ©rĂ©glages d’encodage vidĂ©o
Encodage audio
  • /audio/artwork
    Extraire ou insérer une pochette audio
  • /audio/concat
    ConcatĂ©ner de l’audio
  • /audio/split
    DĂ©couper de l’audio
  • /audio/encode
    Encoder de l’audio
  • /audio/loop
    Mettre de l’audio en boucle
  • /audio/merge
    Fusionner des fichiers audio en un seul
  • /audio/waveform
    GĂ©nĂ©rer des images de forme d’onde Ă  partir d’audio
  • PrĂ©rĂ©glages d’encodage audio
Traitement d’images
  • /image/bgremove
    Supprimer l’arriùre-plan des images
  • /image/enhance
    Améliorer des images
  • /image/merge
    Fusionner plusieurs images en une seule
  • /image/optimize
    Optimiser la taille des fichiers image
  • /image/resize
    Convertir des images, les redimensionner ou y ajouter un filigrane
Traitement de documents
  • /document/autorotate
    Faire pivoter automatiquement des documents
  • /document/convert
    Convertir des documents dans différents formats
  • /document/extract
    Extraire du texte et des images intégrées
  • /document/merge
    Fusionner des documents en un seul
  • /document/optimize
    Optimiser la taille des fichiers PDF
  • /file/read
    Lire le contenu de fichiers
  • /document/split
    Extraire des pages
  • /document/thumbs
    Extraire des miniatures de documents
  • /document/watermark
    Ajouter un filigrane aux documents PDF
  • /html/convert
    Prendre des captures d’écran de pages web ou de fichiers HTML
Intelligence artificielle
  • /document/ocr
    ReconnaĂźtre le texte dans des documents (OCR)
  • /image/describe
    ReconnaĂźtre des objets dans des images
  • /image/facedetect
    Détecter des visages dans des images
  • /image/generate
    Générer des images à partir de consignes textuelles
  • /image/upscale
    Augmenter la résolution des images
  • /image/ocr
    ReconnaĂźtre le texte dans des images (OCR)
  • /speech/transcribe
    Transcrire la parole dans des fichiers audio ou vidéo
  • /text/speak
    Synthétiser la parole à partir de documents
  • /text/translate
    Traduire le texte de documents
  • /ai/chat
    Générer des réponses de chat par IA
  • /video/generate
    Générer des vidéos à partir de consignes textuelles
Filtrage et sécurité des fichiers
  • /file/filter
    Filtrer des fichiers
  • /file/verify
    Vérifier le type de fichier
  • /file/virusscan
    Analyser des fichiers Ă  la recherche de virus
Catalogage de médias
  • /file/hash
    Calculer le hachage de fichiers
  • /file/preview
    GĂ©nĂ©rer une miniature d’aperçu
  • /meta/write
    Écrire des mĂ©tadonnĂ©es dans des mĂ©dias
Compression de fichiers
  • /file/compress
    Compresser des fichiers
  • /file/decompress
    Décompresser des archives
Évaluation de code
  • /http/request
    Appeler des points de terminaison HTTP
  • /script/run
    Exécuter des scripts dans des Assemblies
Exportation de fichiers
  • TĂ©lĂ©charger
  • /azure/store
    Exporter des fichiers vers Microsoft Azure
  • /backblaze/store
    Exporter des fichiers vers Backblaze
  • /box/store
    Exporter des fichiers vers Box
  • /mega/store
    Exporter des fichiers vers MEGA S4 Object Storage
  • /cloudfiles/store
    Exporter des fichiers vers Rackspace Cloud Files
  • /cloudflare/store
    Exporter des fichiers vers Cloudflare R2
  • /digitalocean/store
    Exporter des fichiers vers DigitalOcean Spaces
  • /dropbox/store
    Exporter des fichiers vers Dropbox
  • /ftp/store
    Exporter des fichiers vers des serveurs FTP
  • /google/store
    Exporter des fichiers vers Google Cloud Storage
  • /minio/store
    Exporter des fichiers vers MinIO
  • /s3/store
    Exporter des fichiers vers Amazon S3
  • /sftp/store
    Exporter des fichiers vers des serveurs SFTP
  • /supabase/store
    Exporter des fichiers vers Supabase Storage
  • /swift/store
    Exporter des fichiers vers OpenStack Swift
  • /tigris/store
    Exporter des fichiers vers Tigris
  • /transloadit/store
    Stocker des fichiers dans Transloadit Storage
  • /tus/store
    Exporter des fichiers vers des serveurs compatibles tus
  • /vimeo/store
    Exporter des fichiers vers Vimeo
  • /wasabi/store
    Exporter des fichiers vers Wasabi
  • /youtube/store
    Exporter des fichiers vers YouTube
Smart CDN
  • /file/serve
    Servir des fichiers aux navigateurs web
  • /tlcdn/deliver
    Mettre en cache et distribuer des fichiers Ă  l’échelle mondiale
  • Tarifs

Extraire des vignettes de vidéos

Le Robot đŸ€–/video/thumbs extrait un nombre quelconque d’images de vidĂ©os pour les utiliser comme aperçus.

Robot /video/thumbs

DĂ©finissez smart: true pour sĂ©lectionner par IA des images d’aperçu pertinentes au lieu d’extraire des images uniquement Ă  intervalles rĂ©guliers. Le Robot Ă©value les images candidates selon leur nettetĂ©, leur luminositĂ©, leur composition, les visages, les expressions, l’action et l’intĂ©rĂȘt visuel, puis renvoie les count meilleures images dans l’ordre chronologique. Les rĂ©sultats de la sĂ©lection intelligente incluent file.meta.smart_score et file.meta.smart_reasons. Si l’évaluation par IA n’est pas disponible, l’Assembly continue avec les images candidates dans l’ordre de repli et inclut un avertissement. Aucune information d’identification IA n’est requise.

Les images des vidĂ©os HDR HLG et PQ font l’objet d’un mappage tonal vers le SDR sRGB avant l’encodage de l’image, y compris les images candidates des vignettes intelligentes. Cela prĂ©serve l’apparence prĂ©vue dans les navigateurs qui affichent les vignettes en tant qu’images sRGB. Les entrĂ©es SDR conservent leur traitement existant.

Tarification de l’IA

Les frais de traitement habituels de /video/thumbs s’appliquent toujours. L’analyse des images par IA est facturĂ©e sĂ©parĂ©ment au coĂ»t du fournisseur sous-jacent, majorĂ© d’une marge Transloadit de 50 %. La sĂ©lection intelligente utilise le modĂšle de vision dĂ©diĂ© openai/gpt-5.4-mini avec le niveau de raisonnement low, indĂ©pendamment du modĂšle par dĂ©faut du Robot /ai/chat. Le montant exact des frais d’IA varie selon le nombre d’images candidates et la tarification du fournisseur.

L’IA Ă©value des copies d’aperçu limitĂ©es Ă  512 pixels sur le cĂŽtĂ© le plus long, en prĂ©servant le rapport hauteur/largeur et sans agrandir les images plus petites. Les vignettes renvoyĂ©es conservent les dimensions et le format de sortie demandĂ©s ; des sorties plus grandes n’agrandissent pas l’aperçu d’évaluation au-delĂ  de cette limite.

smart_max_candidates est le principal levier de contrĂŽle du coĂ»t et de la latence. Le Robot analyse jusqu’à trois images candidates par vignette demandĂ©e, dans la limite de smart_max_candidates, mais jamais moins que count. Avec les valeurs par dĂ©faut count: 8 et smart_max_candidates: 20, il analyse 20 images et renvoie les 8 meilleures. RĂ©duisez la limite d’images candidates pour diminuer le coĂ»t et la latence de l’IA. L’augmenter peut Ă©largir l’ensemble des images candidates jusqu’à trois fois count ; des limites plus Ă©levĂ©es n’ont aucun effet.

Note

Utilisez count avec la sélection intelligente. Pour extraire systématiquement des horodatages exacts avec offsets, définissez smart: false.

Note

MĂȘme si les vignettes sont extraites des vidĂ©os en parallĂšle, nous les trions avant de les ajouter aux rĂ©sultats de l’Assembly. L’ordre dans lequel elles y apparaissent reflĂšte donc leur ordre d’apparition dans la vidĂ©o. Vous pouvez Ă©galement le vĂ©rifier Ă  l’aide de la clĂ© de mĂ©tadonnĂ©es thumb_index.

Pour un Template qui gĂ©nĂšre une image d’affiche Ă  partir d’un tĂ©lĂ©versement, l’utilisation des SDK et les vĂ©rifications avant publication, consultez le guide du flux de travail vidĂ©o HTML. La dĂ©mo vidĂ©o et S3 EN (English) comprend une entrĂ©e enregistrĂ©e et des images extraites.

Exemple d’utilisation

Sélectionner par IA trois vignettes visuellement attrayantes dans chaque vidéo téléversée :

{
  "steps": {
    "thumbnailed": {
      "count": 3,
      "ffmpeg_stack": "v7",
      "robot": "/video/thumbs",
      "smart": true,
      "smart_max_candidates": 12,
      "use": ":original"
    }
  }
}

ParamĂštres

  • interpolate

    boolean | Record<string, boolean>

    DĂ©termine si les Assembly Variables sont interpolĂ©es pour chaque champ d’instruction.

    Par dĂ©faut, la plupart des champs d’instruction des Robots interpolent les Assembly Variables. DĂ©finissez ce paramĂštre sur false pour traiter tous les champs d’instruction comme du texte littĂ©ral, ou dĂ©finissez le chemin d’un champ individuel sur false pour traiter uniquement ce champ comme du texte littĂ©ral. Pour les champs propres Ă  un Robot qui sont littĂ©raux par dĂ©faut, dĂ©finissez ce paramĂštre sur true ou dĂ©finissez le chemin de ce champ sur true pour rĂ©activer l’interpolation.

    Utilisez des noms de champs tels que path, ou des chemins avec points tels que ffmpeg.vf pour les objets imbriqués.

  • output_meta

    Record<string, boolean> | boolean | Array<string>

    Demande des métadonnées coûteuses en CPU, désactivées par défaut pour accélérer les Assemblies.

    Pour les images, "has_transparency": true dĂ©tecte la transparence et "dominant_colors": true extrait les couleurs hexadĂ©cimales. Ajoutez "dominant_colors_sampled": true pour obtenir plus rapidement des couleurs approximatives Ă  partir de versions rĂ©duites de l’image. L’échantillonnage nĂ©cessite dominant_colors et ne modifie ni les octets de l’image ni la facturation. Sa mĂ©thode et sa palette peuvent varier. Omettez-le ou dĂ©sactivez-le pour obtenir des couleurs en pleine rĂ©solution.

    Pour les images, vous pouvez Ă©galement ajouter "blurhash": true pour extraire une chaĂźne BlurHash⁠ — une reprĂ©sentation compacte d’un espace rĂ©servĂ© pour l’image, utile pour afficher un aperçu flou pendant le chargement de l’image complĂšte.

    Pour les images, "thumbhash": true extrait plutĂŽt un ThumbHash⁠ encodĂ© en base64 dans meta.thumbhash, accompagnĂ© de meta.has_alpha (qui indique si un canal alpha existe, mĂȘme lorsque l’image est entiĂšrement opaque). Il dĂ©crit les pixels orientĂ©s selon les donnĂ©es EXIF et utilise la premiĂšre image des images animĂ©es. L’extraction est effectuĂ©e au mieux : les images de plus de 40 mĂ©gapixels, les formats non pris en charge ou un Ă©chec de dĂ©codage ou un dĂ©codage limitĂ© ne produisent aucun espace rĂ©servĂ©. Une extraction rĂ©ussie ajoute des frais de mĂ©tadonnĂ©es Ă©quivalents Ă  20 % des octets de ce fichier. Aucun supplĂ©ment ThumbHash ne s’applique lorsque l’option est dĂ©sactivĂ©e ou lorsqu’aucun hash n’est produit.

    DĂ©finissez cette option sur le Step qui produit l’image, par exemple /upload/handle pour les originaux tĂ©lĂ©versĂ©s ou /image/resize pour les sorties traitĂ©es. La dĂ©finir uniquement sur /transloadit/store ne demande pas l’extraction : le stockage conserve les mĂ©tadonnĂ©es du Step producteur. Transloadit Storage conserve un hash gĂ©nĂ©rĂ© avec sa version immuable et le renvoie dans les rĂ©sultats stockĂ©s et lors des lectures natives de ressources. Les tĂ©lĂ©versements directs vers S3 ne gĂ©nĂšrent pas d’espaces rĂ©servĂ©s. Un espace rĂ©servĂ© contient des informations sur l’image : protĂ©gez-le donc avec les mĂȘmes contrĂŽles d’accĂšs que l’image complĂšte.

    Pour les vidĂ©os, vous pouvez ajouter le paramĂštre "colorspace": true pour extraire l’espace colorimĂ©trique de la vidĂ©o de sortie.

    Pour les vidĂ©os, vous pouvez Ă©galement ajouter "interlaced": true pour dĂ©tecter si la vidĂ©o est entrelacĂ©e. Cette option combine l’indicateur ffprobe peu coĂ»teux field_order avec une passe d’échantillonnage idet limitĂ©e sur les premiĂšres images de la source, et expose interlaced, field_order ainsi qu’un objet de diagnostic interlace_detection sous file.meta. Cette opĂ©ration est coĂ»teuse en calcul et facturĂ©e en consĂ©quence.

    Pour l’audio, vous pouvez ajouter "mean_volume": true pour obtenir une valeur unique reprĂ©sentant le volume moyen du fichier audio.

    Vous pouvez Ă©galement dĂ©finir cette option sur false pour ignorer l’extraction des mĂ©tadonnĂ©es et accĂ©lĂ©rer le transcodage.

  • user_meta

    Record<string, any>(par défaut : {})

    Ajoute des métadonnées JSON personnalisées à chaque fichier émis sans modifier son contenu. Les objets et tableaux imbriqués sont pris en charge.

    L’hĂ©ritage dĂ©pend du Robot. Les valeurs sont fusionnĂ©es avec la valeur user_meta existante du fichier de sortie ; le Step actuel remplace les clĂ©s de premier niveau correspondantes. Attribuez explicitement les clĂ©s requises lorsqu’un Robot crĂ©e de nouvelles sorties.

    Dans les Steps de traitement, ${file.*} dĂ©signe la premiĂšre entrĂ©e et ${result.*} le fichier Ă©mis. Les valeurs sont Ă©valuĂ©es pour chaque sortie aprĂšs l’exĂ©cution du Robot, avant l’extraction ultĂ©rieure des mĂ©tadonnĂ©es et le stockage temporaire. Sur :original, les valeurs sont Ă©valuĂ©es pour chaque tĂ©lĂ©versement avant l’extraction des mĂ©tadonnĂ©es.

    Les Steps en aval lisent ${file.user_meta.key}. Consultez MĂ©tadonnĂ©es personnalisĂ©es pour un exemple complet et les rĂšgles d’hĂ©ritage.

  • result

    boolean(par défaut : false)

    Indique si les rĂ©sultats de ce Step doivent figurer dans l’Assembly Status JSON

  • queue

    batch

    DĂ©finir la file d’attente sur « batch » abaisse manuellement la prioritĂ© des Jobs de ce Step afin d’éviter de consommer des emplacements prioritaires de Jobs pour des Jobs qui n’ont pas besoin d’un temps d’attente nul dans la file

  • force_accept

    boolean(par défaut : false)

    Forcer un Robot Ă  accepter un type de fichier qu’il aurait ignorĂ©.

    Par dĂ©faut, les Robots ignorent les fichiers qu’ils ne connaissent pas. Le Robot đŸ€–/video/encode, par exemple, ignorera volontiers les images en entrĂ©e.

    Avec le paramĂštre force_accept dĂ©fini sur true, vous pouvez forcer les Robots Ă  accepter tous les fichiers qui leur sont envoyĂ©s. Cela entraĂźne gĂ©nĂ©ralement des erreurs et ne doit ĂȘtre utilisĂ© que pour le dĂ©bogage ou pour traiter des cas limites.

  • ignore_errors

    boolean | Array<meta | execute>(par défaut : [])

    Ignore les erreurs pendant certaines phases du traitement.

    Si vous dĂ©finissez cette valeur sur ["meta"], le Robot ignorera les erreurs lors de l’extraction des mĂ©tadonnĂ©es.

    Si vous dĂ©finissez cette valeur sur ["execute"], le Robot ignorera les erreurs lors de la phase d’exĂ©cution principale.

    Définir cette valeur sur true équivaut à ["meta", "execute"] : les erreurs seront alors ignorées dans les deux phases.

  • use

    string | Array<string> | Array<object> | object

    Indique quel(s) Step(s) utiliser comme entrée.

    • Vous pouvez choisir n’importe quel nom pour les Steps, sauf ":original" (rĂ©servĂ© aux tĂ©lĂ©versements des utilisateurs gĂ©rĂ©s par Transloadit)
    • Vous pouvez fournir plusieurs Steps en entrĂ©e Ă  l’aide de tableaux :
      {
        "use": [
          ":original",
          "encoded",
          "resized"
        ]
      }
      
    • Vous pouvez Ă©galement Ă©tiqueter les Steps d’entrĂ©e avec as pour transmettre une intention sĂ©mantique aux Robots :
      {
        "use": [
          {
            "name": ":original",
            "as": "image"
          },
          {
            "name": ":original",
            "as": "mask"
          }
        ]
      }
      
    Astuce

    C’est probablement tout ce que vous devez savoir sur use, mais vous pouvez consulter les cas d’utilisation avancĂ©s.

  • ffmpeg

    object

    Un objet de paramÚtres à transmettre à FFmpeg. Si un préréglage est utilisé, les options spécifiées sont fusionnées par-dessus celles du préréglage. Pour connaßtre les options disponibles, consultez la documentation de FFmpeg⁠. Les options spécifiées ici ont priorité sur celles du préréglage.

  • ffmpeg_stack

    v6 | v7 | v8 | string(par défaut : "v6.0.0")

    SĂ©lectionne la version de la pile FFmpeg Ă  utiliser pour l’encodage. Nous recommandons actuellement d’utiliser « v7 ». Les versions exactes « v6.0.0 », « v7.0.0 » et « v8.0.0 » sont des valeurs hĂ©ritĂ©es qui restent acceptĂ©es pour assurer la rĂ©trocompatibilitĂ©. Les valeurs « v5.x », dĂ©prĂ©ciĂ©es, sont Ă©galement acceptĂ©es.

  • count

    string | number(par défaut : 8)

    Le nombre de vignettes Ă  extraire. Comme certaines vidĂ©os ont des durĂ©es incorrectes, le nombre rĂ©el de vignettes gĂ©nĂ©rĂ©es peut, dans de rares cas, ĂȘtre infĂ©rieur. Le nombre maximal de vignettes que nous autorisons actuellement est de 999.

    Lorsque smart vaut false, les vignettes sont prises Ă  intervalles rĂ©guliers. Par exemple, une valeur de 3 produit des vignettes Ă  25 %, 50 % et 75 % de la durĂ©e de la vidĂ©o. Avec smart: true, il s’agit plutĂŽt du nombre de vignettes sĂ©lectionnĂ©es parmi l’ensemble des images candidates.

    Pour extraire des vignettes à des horodatages précis, utilisez le paramÚtre offsets.

  • offsets

    Array<string | number> | Array<string> | null

    Un tableau de dĂ©calages reprĂ©sentant des secondes de la durĂ©e du fichier, par exemple [ 2, 45, 120 ]. Des durĂ©es en millisecondes peuvent Ă©galement ĂȘtre utilisĂ©es Ă  l’aide de valeurs dĂ©cimales. Par exemple, un dĂ©calage de 1250 millisecondes serait reprĂ©sentĂ© par 1.25. Les dĂ©calages peuvent aussi ĂȘtre des valeurs en pourcentage, comme [ "2%", "50%", "75%" ].

    Lorsque smart vaut false, offsets a prioritĂ© sur count. Demandez des horodatages compris dans la durĂ©e de la vidĂ©o. Si FFmpeg ne produit aucune image Ă  un dĂ©calage demandĂ©, le Robot peut rĂ©essayer sans positionnement par horodatage et renvoyer Ă  la place une image proche du dĂ©but. Il n’ignore pas simplement le dĂ©calage, et l’extraction peut tout de mĂȘme Ă©chouer si aucune image n’est disponible.

    Lorsque smart vaut true, la sĂ©lection intelligente ignore offsets et utilise count pour faire son choix parmi ses propres horodatages candidats. Si aucune image candidate de la sĂ©lection intelligente ne peut ĂȘtre extraite, le Robot revient Ă  l’extraction standard, oĂč offsets a prioritĂ©. Utilisez smart: false pour extraire systĂ©matiquement les horodatages indiquĂ©s.

    Utilisez null pour laisser count et smart déterminer la sélection des horodatages.

  • format

    jpeg | jpg | png(par défaut : "jpeg")

    Le format de la vignette extraite. Les valeurs prises en charge sont "jpg", "jpeg" et "png". MĂȘme si vous indiquez le format "jpeg", les vignettes obtenues auront l’extension de fichier "jpg".

  • width

    string | number | null

    La largeur de la vignette, en pixels. Omettez ce paramĂštre ou utilisez null pour conserver la largeur d’origine de la vidĂ©o.

  • height

    string | number | null

    La hauteur de la vignette en pixels, plafonnĂ©e de la mĂȘme maniĂšre que width. Omettez ce paramĂštre ou utilisez null pour conserver la hauteur d’origine.

  • resize_strategy

    crop | fit | fillcrop | min_fit | pad | stretch(par défaut : "pad")

    L’une des stratĂ©gies de redimensionnement disponibles.

  • background

    string(par défaut : "#000000ff")

    La couleur d’arriĂšre-plan des vignettes obtenues, au format "rrggbbaa" (rouge, vert, bleu, alpha), lorsque ce paramĂštre est utilisĂ© avec la stratĂ©gie de redimensionnement "pad". La couleur par dĂ©faut est le noir opaque.

  • rotate

    0 | 90 | 180 | 270 | 360(par défaut : 0)

    Force la rotation de la vidĂ©o selon le nombre entier de degrĂ©s indiquĂ©. Actuellement, seuls les multiples de 90 sont pris en charge. Nous corrigeons automatiquement l’orientation de nombreuses vidĂ©os lorsque celle-ci est fournie par la camĂ©ra. Cette option n’est utile que pour les vidĂ©os nĂ©cessitant une rotation parce que leur orientation n’a pas Ă©tĂ© dĂ©tectĂ©e par la camĂ©ra.

  • input_codec

    string

    Indique le codec d’entrĂ©e Ă  utiliser pour dĂ©coder la vidĂ©o. Cela est utile pour les vidĂ©os dotĂ©es de codecs particuliers qui nĂ©cessitent des dĂ©codeurs spĂ©cifiques.

  • smart

    boolean(par défaut : false)

    Lorsqu’il est dĂ©fini sur true, ce paramĂštre active la sĂ©lection intelligente de vignettes par IA. Au lieu de renvoyer des vignettes Ă  intervalles rĂ©guliers, le Robot analyse les images candidates et sĂ©lectionne les plus attrayantes visuellement.

    L’IA Ă©value les images selon les critĂšres suivants :

    • NettetĂ© visuelle (en Ă©vitant les images floues ou sombres)
    • QualitĂ© de la composition
    • PrĂ©sence et expressions des visages
    • Action et mouvement (en Ă©vitant les images de transition)
    • IntĂ©rĂȘt visuel global

    Les frais de traitement habituels de /video/thumbs s’appliquent toujours. L’analyse des images par IA utilise un modĂšle de vision dĂ©diĂ© Ă  faible coĂ»t avec le niveau de raisonnement low, ainsi que des copies d’aperçu limitĂ©es Ă  512 pixels sur le cĂŽtĂ© le plus long. Les vignettes renvoyĂ©es conservent les dimensions et le format demandĂ©s. L’analyse est facturĂ©e sĂ©parĂ©ment au coĂ»t du fournisseur sous-jacent, majorĂ© d’une marge Transloadit de 50 %. Vous n’avez pas besoin de fournir d’informations d’identification IA.

    Le mode intelligent gĂ©nĂšre ses propres horodatages candidats rĂ©guliĂšrement espacĂ©s ; utilisez smart: false avec offsets lorsque vous avez besoin d’horodatages prĂ©cis. Les vignettes intelligentes sĂ©lectionnĂ©es sont renvoyĂ©es dans l’ordre chronologique, et non dans l’ordre des scores. Examinez meta.thumb_offset, meta.smart_score et meta.smart_reasons lorsque vous Ă©valuez la sĂ©lection.

    Si l’évaluation par IA Ă©choue, le Robot sĂ©lectionne les images candidates extraites dans l’ordre chronologique et enregistre un motif de repli. En l’absence d’images candidates, il tente une extraction standard. Ces deux replis ajoutent un avertissement Ă  l’Assembly. Une Assembly terminĂ©e ne garantit pas une image d’affiche reprĂ©sentative ou adaptĂ©e Ă  la publication ; vĂ©rifiez que les rĂ©sultats existent et appliquez la politique de vĂ©rification de votre application.

  • smart_max_candidates

    string | number(par défaut : 20)

    La taille maximale de l’ensemble des images candidates lorsque smart vaut true. Le Robot analyse jusqu’à trois images candidates par vignette demandĂ©e, dans la limite de cette valeur, mais il n’analysera jamais moins d’images candidates que la valeur count demandĂ©e.

    Un nombre plus Ă©levĂ© peut donner de meilleurs rĂ©sultats, mais augmente le temps de traitement et le coĂ»t de l’IA. Avec les valeurs par dĂ©faut count: 8 et smart_max_candidates: 20, le Robot analyse 20 images et renvoie les 8 meilleures dans l’ordre chronologique.

    Relever cette limite au-delĂ  de trois fois count n’élargit pas l’ensemble des images candidates. Par exemple, avec count: 1, le Robot analyse au plus trois images candidates.

    Ce paramĂštre n’est utilisĂ© que lorsque smart vaut true.

Démonstrations

  • Encode video, extract thumbnails and store on S3 EN (English)
  • Service to convert any video to animated GIF EN (English)

Articles de blog associés

  • AmĂ©liorer FFmpeg pour des performances d’encodage supĂ©rieures 30 juillet 2015
  • IntĂ©gration Zapier de Transloadit 27 octobre 2017
  • Nouveau modĂšle tarifaire pour les futurs clients de Transloadit 7 fĂ©vrier 2018
  • DĂ©couverte du Robot /google/store dans la sĂ©rie Re-Loadit 1 mars 2019
  • Guide d’encodage de vidĂ©os pour le streaming avec Transloadit 28 avril 2020
  • Migrer depuis Cloudinary, Filestack, Mux ou Uploadcare 9 septembre 2026
  • Let AI pick your video thumbnails EN (English) 12 octobre 2026
Page prĂ©cĂ©dente ← /video/subtitlePage suivante /audio/artwork →
Contacter le support
TransloaditVĂ©rification de l’état


Produit

  • Services
  • Tarifs
  • DĂ©mos EN (English)
  • Outils
  • SĂ©curitĂ©
  • Support

Entreprise

  • À propos de Transloadit/Presse
  • Blog/CarriĂšres EN (English)
  • Comparatifs/Matrice de conformitĂ©
  • Recherche EN (English)
  • Projets open source
  • Solutions
  • Pionniers du web

Documentation

  • Premiers pas
  • Transcodage
  • FAQ
  • API
  • Guides/Astuces dev
  • Formats pris en charge

Plus

  • État de la plateforme⁠
  • Forum de la communauté⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

TransloaditÂź, tusÂź et UppyÂź sont des marques dĂ©posĂ©es de Transloadit-II GmbH aux États-Unis.

Confidentialité EN (English)Conditions EN (English)Mentions légales EN (English)Marques déposées EN (English)Politique DMCA EN (English)
EnglishDeutschEspañolFrançaisPortuguĂȘs (Brasil)æ—„æœŹèȘž