Comment déboguer les images Base64 dans les réponses JSON d'API

Le problème du Base64 dans le JSON

Les API d'IA multimodales — génération d'images, OCR, synthèse vocale — renvoient couramment les médias sous forme de chaînes Base64 dans les réponses JSON. Les visionneuses JSON traditionnelles traitent ces chaînes comme du texte brut, vous laissant face à des murs de caractères encodés sans aucun moyen de voir le contenu réel.

La solution habituelle est un processus en plusieurs étapes : localiser le champ Base64, copier la chaîne, ouvrir un site de décodage, coller, décoder et télécharger. Pour un seul champ, c'est fastidieux — pour des réponses contenant plusieurs valeurs Base64, cela devient un véritable goulot d'étranglement.

À quoi ressemble une réponse API d'IA typique

Voici une réponse simplifiée de génération d'images DALL·E avec plusieurs variations :

{
  "created": 1709055842,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAA...",
      "revised_prompt": "Un paysage montagneux serein au coucher du soleil"
    },
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgBBB...",
      "revised_prompt": "Un paysage montagneux serein au lever du soleil"
    },
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgCCC...",
      "revised_prompt": "Un paysage montagneux serein à midi"
    }
  ]
}

Chaque champ "b64_json" contient une image PNG complète encodée en Base64. Dans une visionneuse JSON classique, vous verriez trois murs de texte. Impossible de les visualiser, de les comparer ou même de confirmer qu'il s'agit d'images valides sans décoder chacune individuellement.

Une meilleure méthode : détection et aperçu automatiques en ligne

ViewJSON détecte automatiquement les médias encodés en Base64 dans votre JSON et affiche des aperçus en ligne — les images sous forme de vignettes, l'audio sous forme de lecteurs, les vidéos sous forme de lecteurs intégrés et les PDF sous forme d'aperçus de documents.

Comment fonctionne la détection ?

ViewJSON ne devine pas en se basant sur les noms de champs ou la longueur des chaînes. Il utilise la détection par nombres magiques, la même technique que les systèmes d'exploitation utilisent pour identifier les types de fichiers.

Le processus est simple :

1. Pour chaque valeur de chaîne dans votre JSON, ViewJSON ne décode que les 64 premiers octets du contenu Base64
2. Il compare ces octets à une bibliothèque de signatures de formats de fichiers (nombres magiques) connus
3. Si une correspondance est trouvée (par ex., 89 50 4E 47 pour PNG, ou FF D8 FF pour JPEG), l'aperçu approprié est affiché

Cette approche est rapide. Même une chaîne Base64 de 100 Mo est identifiée en moins d'une milliseconde car seuls les 64 premiers octets sont décodés pour la détection. Le contenu complet n'est décodé que lorsque vous développez réellement l'aperçu.

Formats pris en charge

ViewJSON détecte et prévisualise actuellement plus de 15 formats multimédia :

Étape par étape : déboguez votre réponse API

1. Ouvrez ViewJSON — Rendez-vous sur viewjson.net
2. Collez votre JSON — Copiez la réponse API complète depuis votre terminal, Postman ou votre code, et collez-la dans l'éditeur. Le JSON mal formé (virgules traînantes, commentaires, clés sans guillemets) est automatiquement réparé.
3. Visualisez les aperçus — Les champs Base64 sont détectés automatiquement. Cliquez sur l'icône œil (👁) à côté de n'importe quel champ multimédia détecté pour basculer son aperçu en ligne.
4. Comparez les résultats — Avec tous les aperçus visibles, vous pouvez parcourir le JSON pour comparer plusieurs images côte à côte, sans outils supplémentaires.
5. Partagez avec votre équipe — Utilisez le bouton de partage pour générer une URL compressée contenant la structure JSON. Notez que les charges utiles Base64 très volumineuses peuvent être tronquées dans le lien partagé en raison des limites de longueur d'URL.

Quand est-ce le plus utile ?

• Validation des résultats DALL·E / Stable Diffusion — Les API de génération d'images renvoient souvent plusieurs variations Base64. ViewJSON vous permet de voir toutes les images côte à côte pour choisir la meilleure sans décoder chacune individuellement.
• Inspection des régions de recadrage OCR — Les pipelines OCR par lots renvoient des dizaines de régions d'images recadrées en Base64. Les visualiser en ligne révèle immédiatement les zones mal alignées ou incorrectement recadrées.
• Comparaison de variations de voix TTS — Lors du test de différentes voix ou styles de parole dans les API de synthèse vocale, vous pouvez écouter chaque extrait audio directement dans le JSON pour les comparer.
• Revue des captures HTTP — Collez le JSON depuis l'historique de requêtes Postman ou Fiddler pour voir les médias réellement envoyés ou reçus, au lieu de parcourir des chaînes encodées.

Confidentialité

Tout le traitement s'effectue dans votre navigateur. Vos données JSON et Base64 ne sont jamais envoyées à aucun serveur, ce qui rend ViewJSON sûr pour les réponses API propriétaires et le contenu sensible.