LLM

Envoyer des images aux LLM (vision) via l'API

Dans POST /llm/chat/completions, le content d'un message peut mêler des parties text et image_url, comme chez OpenAI. Les modèles avec supports_vision dans GET /llm/models acceptent les images, et Connect traduit image_url pour Anthropic : le code est donc le même.

L'appel

POST /api/llm/chat/completions
Authorization: Bearer <merchant token>

{
  "model": "anthropic/claude-sonnet-5-5",
  "max_tokens": 512,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Describe this ad creative."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/creative.jpg"
          }
        }
      ]
    }
  ]
}

Ce que vous pouvez faire

  • Demander au modèle de décrire ou d'analyser une image.
  • Mêler texte et plusieurs images dans le même message.
  • Vérifier dans GET /llm/models quels modèles ont supports_vision.
  • Combiner images avec stream et le repli.

Règles et limites

  • Les parties image_url ne sont acceptées que si chaque modèle de l'appel (model et chaque élément de models) a supports_vision. Sinon : 400 llm_unsupported_field.
  • Chez Anthropic, les parties audio ou fichier renvoient 400 llm_unsupported_field ; les images via image_url sont traduites.
  • Le corps de la requête fait 1 Mo au maximum (413 llm_request_too_large).
  • max_tokens reste obligatoire et ne peut dépasser ni le plafond du compte ni le max_output_tokens des modèles.
  • Les images comptent comme des tokens d'entrée, facturés par le fournisseur sur votre clé.

Champs principaux

ChampTypeObligatoireDescription
modelstringOuiId du modèle, issu de GET /llm/models, au format fournisseur/modèle.
messagesarrayOuiLa conversation. content peut être du texte ou des parties text et image_url.
max_tokensintegerOuiObligatoire (ou max_completion_tokens). Jusqu'au plafond du compte et au max_output_tokens de chaque modèle de l'appel.
modelsarrayNonRepli : jusqu'à 3 modèles de GET /llm/models, essayés dans l'ordre si model échoue avant le premier token.

Pour qui

  • Analyse de visuels publicitaires

    Votre produit envoie le visuel d'une campagne et reçoit une évaluation de l'image et du texte.

  • Texte alternatif et légendes

    Générez des descriptions d'images pour les publications des clients directement depuis votre SaaS.

  • Agents qui lisent captures et graphiques

    Un agent reçoit la capture d'un dashboard et explique les chiffres en texte.

Questions fréquentes

Quels modèles acceptent les images ?

Ceux dont supports_vision est vrai dans GET /llm/models. Envoyer image_url à un modèle qui ne l'a pas renvoie 400 llm_unsupported_field.

Comment envoyer l'image ?

Comme chez OpenAI : une partie du content avec type image_url et l'objet image_url. Connect la traduit pour Anthropic.

Y a-t-il une limite de taille ?

Tout le corps de la requête peut faire jusqu'à 1 Mo. Au-delà, la réponse est 413 llm_request_too_large.

Voir aussi

Voir tout ce que vous pouvez faire avec LLM

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.