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
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| model | string | Oui | Id du modèle, issu de GET /llm/models, au format fournisseur/modèle. |
| messages | array | Oui | La conversation. content peut être du texte ou des parties text et image_url. |
| max_tokens | integer | Oui | Obligatoire (ou max_completion_tokens). Jusqu'au plafond du compte et au max_output_tokens de chaque modèle de l'appel. |
| models | array | Non | Repli : 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.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
