Vision

​

Comment utiliser la vision

• claude.ai. Téléchargez une image comme vous le feriez pour un fichier, ou glissez-déposez une image directement dans la fenêtre de chat.
• Le Console Workbench. Si vous sélectionnez un modèle qui accepte les images (modèles Claude 3 et 4 uniquement), un bouton pour ajouter des images apparaît en haut à droite de chaque bloc de message Utilisateur.
• Requête API. Voir les exemples dans ce guide.

​

Avant de télécharger

​

Bases et limites

​

Évaluer la taille de l’image

​

Calculer les coûts d’image

​

Assurer la qualité de l’image

• Format d’image : Utilisez un format d’image pris en charge : JPEG, PNG, GIF ou WebP.
• Clarté de l’image : Assurez-vous que les images sont claires et pas trop floues ou pixelisées.
• Texte : Si l’image contient du texte important, assurez-vous qu’il est lisible et pas trop petit. Évitez de recadrer le contexte visuel clé juste pour agrandir le texte.

​

Exemples de prompts

​

À propos des exemples de prompts

1. Comme une image encodée en base64 dans des blocs de contenu image
2. Comme une référence URL vers une image hébergée en ligne
3. En utilisant l’API Files (télécharger une fois, utiliser plusieurs fois)

    # Pour les images basées sur URL, vous pouvez utiliser l'URL directement dans votre requête JSON
    
    # Pour les images encodées en base64, vous devez d'abord encoder l'image
    # Exemple de comment encoder une image en base64 en bash :
    BASE64_IMAGE_DATA=$(curl -s "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg" | base64)
    
    # Les données encodées peuvent maintenant être utilisées dans vos appels API

​

Exemple d’image encodée en base64

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "base64",
              "media_type": "image/jpeg",
              "data": "'"$BASE64_IMAGE_DATA"'"
            }
          },
          {
            "type": "text",
            "text": "Décrivez cette image."
          }
        ]
      }
    ]
  }'

​

Exemple d’image basée sur URL

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "url",
              "url": "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
            }
          },
          {
            "type": "text",
            "text": "Décrivez cette image."
          }
        ]
      }
    ]
  }'

​

Exemple d’image API Files

# D'abord, téléchargez votre image vers l'API Files
curl -X POST https://api.anthropic.com/v1/files \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -F "file=@image.jpg"

# Ensuite utilisez le file_id retourné dans votre message
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: files-api-2025-04-14" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "image",
            "source": {
              "type": "file",
              "file_id": "file_abc123"
            }
          },
          {
            "type": "text",
            "text": "Décrivez cette image."
          }
        ]
      }
    ]
  }'

​

Limitations

• Identification de personnes : Claude ne peut pas être utilisé pour identifier (c’est-à-dire nommer) des personnes dans les images et refusera de le faire.
• Précision : Claude peut halluciner ou faire des erreurs lors de l’interprétation d’images de faible qualité, tournées ou très petites de moins de 200 pixels.
• Raisonnement spatial : Les capacités de raisonnement spatial de Claude sont limitées. Il peut avoir des difficultés avec des tâches nécessitant une localisation précise ou des mises en page, comme lire un cadran d’horloge analogique ou décrire les positions exactes des pièces d’échecs.
• Comptage : Claude peut donner des comptes approximatifs d’objets dans une image mais peut ne pas toujours être précisément exact, surtout avec de grands nombres de petits objets.
• Images générées par IA : Claude ne sait pas si une image est générée par IA et peut être incorrect si on le lui demande. Ne comptez pas sur lui pour détecter des images fausses ou synthétiques.
• Contenu inapproprié : Claude ne traitera pas d’images inappropriées ou explicites qui violent notre Politique d’utilisation acceptable.
• Applications de santé : Bien que Claude puisse analyser des images médicales générales, il n’est pas conçu pour interpréter des scans diagnostiques complexes tels que les CT ou IRM. Les sorties de Claude ne doivent pas être considérées comme un substitut à un conseil médical professionnel ou un diagnostic.

​

FAQ

​

Plongez plus profondément dans la vision

• Livre de recettes multimodal : Ce livre de recettes a des conseils sur comment commencer avec les images et techniques de meilleures pratiques pour assurer la performance de la plus haute qualité avec les images. Voyez comment vous pouvez efficacement prompter Claude avec des images pour effectuer des tâches telles que interpréter et analyser des graphiques ou extraire du contenu de formulaires.
• Référence API : Visitez notre documentation pour l’API Messages, incluant des exemples d’appels API impliquant des images.