Comment convertir des images en Base64 pour les requêtes API de vision

Pourquoi les API de vision ont besoin du Base64

Les API de vision modernes comme GPT-4o d'OpenAI, Google Cloud Vision, Anthropic Claude et Qwen-VL acceptent les images de deux manières : une URL publique pointant vers l'image, ou les données brutes de l'image encodées en Base64 directement dans le corps de la requête JSON.

L'approche par URL est simple si votre image est déjà hébergée en ligne. Mais dans de nombreux cas concrets, l'image se trouve sur votre machine locale : une capture d'écran que vous venez de prendre, un scan de document, une image extraite d'une vidéo ou une image de test de votre pipeline de développement. Pour ces cas, l'encodage Base64 est la solution. Il vous permet d'intégrer l'image directement dans la requête API sans avoir à la téléverser sur un serveur.

Voici à quoi ressemble une requête API de vision typique avec Base64 :

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Que contient cette image ?"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,iVBORw0KGgo..."
          }
        }
      ]
    }
  ]
}

Le défi est de passer de votre fichier local à cette chaîne Base64, surtout si vous devez le faire de manière répétée pendant le développement et les tests.

Méthodes courantes (et leurs inconvénients)

1. Script Python

import base64

with open("screenshot.png", "rb") as f:
    encoded = base64.b64encode(f.read()).decode()
print(encoded)

Ça fonctionne, mais il faut avoir Python installé, écrire (ou trouver) le script, puis copier le résultat depuis le terminal. Si vous testez différentes images de manière répétée, vous relancez ce script à chaque fois, puis collez manuellement le résultat dans votre JSON.

2. Ligne de commande

# macOS / Linux
base64 -i screenshot.png | pbcopy

# Windows PowerShell
[Convert]::ToBase64String([IO.File]::ReadAllBytes("screenshot.png")) | Set-Clipboard

Rapide si vous vous souvenez de la syntaxe, mais le résultat n'est qu'une chaîne brute. Vous ne pouvez pas vérifier ce que vous avez. Est-ce la bonne image ? L'encodage est-il correct ? Vous ne le saurez qu'après avoir envoyé la requête API et vérifié le résultat.

3. Convertisseurs Base64 en ligne

De nombreux sites proposent la conversion glisser-déposer de fichiers en Base64. Le problème évident : vous téléversez votre fichier sur le serveur de quelqu'un d'autre. Pour une capture d'écran de test, ça peut aller. Pour des données propriétaires, des documents internes, des images médicales ou tout contenu soumis à un accord de confidentialité, c'est exclu.

Une meilleure méthode : coller, prévisualiser, copier

ViewJSON offre un flux de travail plus simple. Collez une image directement dans l'éditeur, obtenez la chaîne Base64 instantanément, et tout reste dans votre navigateur :

1. Ouvrez ViewJSON — Rendez-vous sur viewjson.net
2. Collez votre image — Copiez une image de n'importe où (explorateur de fichiers, outil de capture, navigateur, application de design) et collez-la directement dans l'éditeur JSON avec Ctrl+V
3. Visualisez l'aperçu — ViewJSON convertit automatiquement l'image en Base64 et l'insère comme valeur de chaîne JSON. Un aperçu en ligne apparaît immédiatement pour vous permettre de vérifier que c'est bien la bonne image.
4. Copiez le Base64 — Cliquez sur le bouton de copie ou sélectionnez la valeur de chaîne. Vous obtenez la chaîne Base64 complète, prête à être collée dans votre charge utile API.

Le flux de travail complet en action :

Gestion des grandes chaînes Base64

Les images encodées en Base64 peuvent être extrêmement longues. Un seul JPEG haute résolution peut produire plus de 100 000 caractères. Pour garder l'éditeur réactif, ViewJSON tronque automatiquement l'affichage des chaînes longues. Mais la troncature est uniquement visuelle.

Lorsque vous copiez une valeur Base64 tronquée, le mécanisme de restauration sans perte du presse-papiers de ViewJSON entre en action. Il détecte que vous copiez une chaîne tronquée et restaure automatiquement le contenu original complet dans votre presse-papiers. Vous obtenez toujours la chaîne Base64 complète et non modifiée, jamais une version tronquée qui produirait un fichier corrompu.

Construction de la charge utile API complète

Une fois votre chaîne Base64 obtenue, vous devez l'intégrer dans le format API approprié. Voici des exemples pour les API de vision les plus courantes :

OpenAI GPT-4o Vision

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Décrivez cette image" },
        {
          "type": "image_url",
          "image_url": {
            "url": "data:image/png;base64,<VOTRE_BASE64_ICI>"
          }
        }
      ]
    }
  ],
  "max_tokens": 300
}

Google Cloud Vision

{
  "requests": [
    {
      "image": {
        "content": "<VOTRE_BASE64_ICI>"
      },
      "features": [
        { "type": "TEXT_DETECTION" }
      ]
    }
  ]
}

Après avoir collé l'image dans ViewJSON, copiez la chaîne Base64 générée et insérez-la dans votre charge utile de requête API. Vous pouvez également utiliser le constructeur de requêtes API de ViewJSON pour configurer l'URL, la méthode, les en-têtes et le corps, puis exporter la requête complète sous forme de commande cURL.

Confidentialité : aucun téléversement requis

Contrairement aux sites de conversion Base64 en ligne, ViewJSON fonctionne entièrement dans votre navigateur. La conversion image vers Base64 s'effectue localement grâce à l'API FileReader intégrée au navigateur. Votre image n'est jamais envoyée à aucun serveur.

Cela le rend adapté à la conversion d'images sensibles : scans médicaux pour les API d'IA en santé, documents internes pour les services OCR, images de produits propriétaires pour les systèmes de recherche visuelle ou tout fichier que vous ne souhaiteriez pas téléverser sur un convertisseur tiers.

Comparaison des méthodes